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
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
BCD tables only load in the browser