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.
FontFace
Constructor
-
FontFace() -
Constructs and returns a new
FontFaceobject, built from an external resource described by a URL or from anArrayBuffer.
Properties
-
FontFace.ascentOverride -
A
CSSOMStringthat retrieves or sets the ascent metric of the font. It is equivalent to theascent-overridedescriptor. -
FontFace.descentOverride -
A
CSSOMStringthat retrieves or sets the descent metric of the font. It is equivalent to thedescent-overridedescriptor. -
FontFace.display -
A
CSSOMStringthat determines how a font face is displayed based on whether and when it is downloaded and ready to use. -
FontFace.family -
A
CSSOMStringthat retrieves or sets the family of the font. It is equivalent to thefont-familydescriptor. -
FontFace.featureSettings -
A
CSSOMStringthat retrieves or sets infrequently used font features that are not available from a font's variant properties. It is equivalent to thefont-feature-settingsdescriptor. -
FontFace.lineGapOverride -
A
CSSOMStringthat retrieves or sets the line-gap metric of the font. It is equivalent to theline-gap-overridedescriptor. -
FontFace.loadedRead only -
Returns a
Promisethat resolves with the currentFontFaceobject when the font specified in the object's constructor is done loading or rejects with aSyntaxError. -
FontFace.statusRead only -
Returns an enumerated value indicating the status of the font, one of
"unloaded","loading","loaded", or"error". -
FontFace.stretch -
A
CSSOMStringthat retrieves or sets how the font stretches. It is equivalent to thefont-stretchdescriptor. -
FontFace.style -
A
CSSOMStringthat retrieves or sets the style of the font. It is equivalent to thefont-styledescriptor. -
FontFace.unicodeRange -
A
CSSOMStringthat retrieves or sets the range of unicode codepoints encompassing the font. It is equivalent to theunicode-rangedescriptor. -
FontFace.variant -
A
CSSOMStringthat retrieves or sets the variant of the font. It is equivalent to thefont-variantdescriptor. -
FontFace.variationSettings -
A
CSSOMStringthat retrieves or sets the variation settings of the font. It is equivalent to thefont-variation-settingsdescriptor. -
FontFace.weight -
A
CSSOMStringthat contains the weight of the font. It is equivalent to thefont-weightdescriptor.
-
FontFace.load() -
Loads a font based on current object's constructor-passed requirements, including a location or source buffer, and returns a
Promisethat resolves with the current FontFace object.
Specifications
| Specification |
|---|
| CSS Font Loading Module Level 3 # fontface-interface |
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
|
22
|
10
|
37
|
35
|
41
|
22
|
10
|
4.0
|
featureSettings |
35
|
79
|
41
|
No
|
22
|
10
|
37
|
35
|
41
|
22
|
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
|
32
22-32
Before Opera 45, the returned promise resolved with void instead of a
FontFace object as required by the specification.
|
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
|
32
22-32
Before Opera 45, the returned promise resolved with void instead of a
FontFace object as required by the specification.
|
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
|
32
22-32
Before Opera 45, the returned promise resolved with void instead of a
FontFace object as required by the specification.
|
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
|
32
22-32
Before Opera 45, the returned promise resolved with void instead of a
FontFace object as required by the specification.
|
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
|
22
|
10
|
37
|
35
|
41
|
22
|
10
|
4.0
|
stretch |
35
|
79
|
41
|
No
|
22
|
10
|
37
|
35
|
41
|
22
|
10
|
4.0
|
style |
35
|
79
|
41
|
No
|
22
|
10
|
37
|
35
|
41
|
22
|
10
|
4.0
|
unicodeRange |
35
|
79
|
41
|
No
|
22
|
10
|
37
|
35
|
41
|
22
|
10
|
4.0
|
variant |
35
|
79
|
41
|
No
|
22
|
No
|
37
|
35
|
41
|
22
|
No
|
4.0
|
variationSettings |
62
|
79
|
62
|
No
|
49
|
No
|
62
|
62
|
62
|
46
|
No
|
8.0
|
weight |
35
|
79
|
41
|
No
|
22
|
10
|
37
|
35
|
41
|
22
|
10
|
4.0
|
worker_support |
69
|
79
|
No
|
No
|
56
|
No
|
69
|
69
|
No
|
48
|
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
