FontFace
The FontFace
interface represents a single usable font face. It allows control of the source of the font face, being a URL to an external resource, or a buffer; it also allows control of when the font face is loaded and its current status.
Constructor
FontFace()
-
Constructs and returns a new
FontFace
object, built from an external resource described by an URL or from anArrayBuffer
.
Properties
FontFace.ascentOverride
-
A
CSSOMString
that retrieves or sets the ascent metric of the font. It is equivalent to theascent-override
descriptor. FontFace.descentOverride
-
A
CSSOMString
that retrieves or sets the descent metric of the font. It is equivalent to thedescent-override
descriptor. FontFace.display
-
A
CSSOMString
that determines how a font face is displayed based on whether and when it is downloaded and ready to use. FontFace.family
-
A
CSSOMString
that retrieves or sets the family of the font. It is equivalent to thefont-family
descriptor. FontFace.featureSettings
-
A
CSSOMString
that retrieves or sets infrequently used font features that are not available from a font's variant properties. It is equivalent to thefont-feature-settings
descriptor. FontFace.lineGapOverride
-
A
CSSOMString
that retrieves or sets the line-gap metric of the font. It is equivalent to theline-gap-override
descriptor. -
FontFace.loaded
Read only -
Returns a
Promise
that resolves with the currentFontFace
object when the font specified in the object's constructor is done loading or rejects with aSyntaxError
. -
FontFace.status
Read only -
Returns an enumerated value indicating the status of the font, one of
"unloaded"
,"loading"
,"loaded"
, or"error"
. FontFace.stretch
-
A
CSSOMString
that retrieves or sets how the font stretches. It is equivalent to thefont-stretch
descriptor. FontFace.style
-
A
CSSOMString
that retrieves or sets the style of the font. It is equivalent to thefont-style
descriptor. FontFace.unicodeRange
-
A
CSSOMString
that retrieves or sets the range of unicode codepoints encompassing the font. It is equivalent to theunicode-range
descriptor. FontFace.variant
-
A
CSSOMString
that retrieves or sets the variant of the font. It is equivalent to thefont-variant
descriptor. FontFace.variationSettings
-
A
CSSOMString
that retrieves or sets the variation settings of the font. It is equivalent to thefont-variation-settings
descriptor. FontFace.weight
-
A
CSSOMString
that contains the weight of the font. It is equivalent to thefont-weight
descriptor.
FontFace.load()
-
Loads a font based on current object's constructor-passed requirements, including a location or source buffer, and returns a
Promise
that resolves with the current FontFace object.
Specifications
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
FontFace |
35 |
79 |
41 |
No |
22 |
10 |
37 |
35 |
41 |
22 |
10 |
4.0 |
FontFace |
35 |
79 |
41 |
No |
22 |
10 |
37 |
35 |
41 |
22 |
10 |
4.0 |
ascentOverride |
87 |
87 |
89 |
No |
73 |
No |
87 |
87 |
89 |
62 |
No |
14.0 |
descentOverride |
87 |
87 |
89 |
No |
73 |
No |
87 |
87 |
89 |
62 |
No |
14.0 |
display |
60 |
79 |
58 |
No |
47 |
10 |
60 |
60 |
58 |
44 |
10 |
8.0 |
family |
35 |
79 |
41 |
No |
Yes |
10 |
37 |
35 |
41 |
Yes |
10 |
4.0 |
featureSettings |
35 |
79 |
41 |
No |
Yes |
10 |
37 |
35 |
41 |
Yes |
10 |
4.0 |
lineGapOverride |
87 |
87 |
89 |
No |
73 |
No |
87 |
87 |
89 |
62 |
No |
14.0 |
load |
45
35-45
Before Chrome 45, the returned promise resolved with void instead of a
FontFace object as required by the specification. |
79 |
41 |
No |
Yes |
10 |
45
37-45
Before WebView 45, the returned promise resolved with void instead of a
FontFace object as required by the specification. |
45
35-45
Before Chrome 45, the returned promise resolved with void instead of a
FontFace object as required by the specification. |
41 |
Yes |
10 |
5.0
4.0-5.0
Before Samsung Internet 5.0, the returned promise resolved with void instead of a
FontFace object as required by the specification. |
loaded |
45
35-45
Before Chrome 45, the returned promise resolved with void instead of a
FontFace object as required by the specification. |
79 |
41 |
No |
Yes |
10 |
45
37-45
Before WebView 45, the returned promise resolved with void instead of a
FontFace object as required by the specification. |
45
35-45
Before Chrome 45, the returned promise resolved with void instead of a
FontFace object as required by the specification. |
41 |
Yes |
10 |
5.0
4.0-5.0
Before Samsung Internet 5.0, the returned promise resolved with void instead of a
FontFace object as required by the specification. |
status |
35 |
79 |
41 |
No |
Yes |
10 |
37 |
35 |
41 |
Yes |
10 |
4.0 |
stretch |
35 |
79 |
41 |
No |
Yes |
10 |
37 |
35 |
41 |
Yes |
10 |
4.0 |
style |
35 |
79 |
41 |
No |
Yes |
10 |
37 |
35 |
41 |
Yes |
10 |
4.0 |
unicodeRange |
35 |
79 |
41 |
No |
Yes |
10 |
37 |
35 |
41 |
Yes |
10 |
4.0 |
variant |
35 |
79 |
41 |
No |
Yes |
No |
37 |
35 |
41 |
Yes |
No |
4.0 |
variationSettings |
62 |
79 |
62 |
No |
49 |
No |
62 |
62 |
62 |
46 |
No |
8.0 |
weight |
35 |
79 |
41 |
No |
Yes |
10 |
37 |
35 |
41 |
Yes |
10 |
4.0 |
worker_support |
69 |
79 |
No |
No |
? |
No |
69 |
69 |
No |
? |
No |
10.0 |
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FontFace