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;
    weight: string;
    load(): Promise<FontFace>;
}
Index

Properties

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 @font-face/descent-override descriptor.

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.

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 @font-face/line-gap-override descriptor.

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

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

weight: string

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

MDN Reference

Methods

  • The load() method of the FontFace interface requests and loads a font whose source was specified as a URL.

    MDN Reference

    Returns Promise<FontFace>