Skip to main content

FontFace

The FontFace interface of the CSS Font Loading API represents a single usable font face.

MDN Reference

Methods​

load()​

load(): Promise<FontFace>;

The load() method of the FontFace interface requests and loads a font whose source was specified as a URL. It returns a Promise that resolves with the current FontFace object.

MDN Reference

Returns​

Promise<FontFace>

Properties​

ascentOverride​

ascentOverride: string;

The ascentOverride property of the FontFace interface returns and sets the ascent metric for the font, the height above the baseline that CSS uses to lay out line boxes in an inline formatting context.

MDN Reference

descentOverride​

descentOverride: string;

The descentOverride property of the FontFace interface returns and sets the value of the descent-override descriptor. The possible values are normal, indicating that the metric used should be obtained from the font file, or a percentage.

MDN Reference

display​

display: FontDisplay;

The display property of the FontFace interface determines how a font face is displayed based on whether and when it is downloaded and ready to use. This property is equivalent to the CSS font-display descriptor.

MDN Reference

family​

family: string;

The FontFace.family property allows the author to get or set the font family of a FontFace object.

MDN Reference

featureSettings​

featureSettings: string;

The featureSettings property of the FontFace interface retrieves or sets infrequently used font features that are not available from a font's variant properties.

MDN Reference

lineGapOverride​

lineGapOverride: string;

The lineGapOverride property of the FontFace interface returns and sets the value of the line-gap-override descriptor. The possible values are normal, indicating that the metric used should be obtained from the font file, or a percentage.

MDN Reference

loaded​

readonly loaded: Promise<FontFace>;

The loaded read-only property of the FontFace interface returns a Promise that resolves with the current FontFace object when the font specified in the object's constructor is done loading or rejects with a SyntaxError.

MDN Reference

status​

readonly status: FontFaceLoadStatus;

The status read-only property of the FontFace interface returns an enumerated value indicating the status of the font, one of "unloaded", "loading", "loaded", or "error".

MDN Reference

stretch​

stretch: string;

The stretch property of the FontFace interface retrieves or sets how the font stretches.

MDN Reference

style​

style: string;

The style property of the FontFace interface retrieves or sets the font's style.

MDN Reference

unicodeRange​

unicodeRange: string;

The unicodeRange property of the FontFace interface retrieves or sets the range of unicode code points encompassing the font.

MDN Reference

variationSettings​

variationSettings: string;

The variationSettings property of the FontFace interface retrieves or sets low-level OpenType or TrueType font variations.

MDN Reference

weight​

weight: string;

The weight property of the FontFace interface retrieves or sets the weight of the font.

MDN Reference