Join us online - 19th of November
Save your spot

Interface FontFace

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

MDN Reference

interface FontFace {
    ascentOverride: string;
    descentOverride: string;
    display: FontDisplay;
    family: string;
    featureSettings: string;
    lineGapOverride: string;
    loaded: Promise<FontFace>;
    status: FontFaceLoadStatus;
    stretch: string;
    style: string;
    unicodeRange: string;
    variationSettings: string;
    weight: string;
    load(): Promise<FontFace>;
}
Index
ascentOverride descentOverride display family featureSettings lineGapOverride loaded status stretch style unicodeRange variationSettings weight
load
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: 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: 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: string

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

MDN Reference

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: 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: 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: 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: string

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

MDN Reference

style: string

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

MDN Reference

unicodeRange: string

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

MDN Reference

variationSettings: string

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

MDN Reference

weight: string

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

MDN Reference

  • 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>

Was this helpful?