FontFaceSet - Web APIs 编辑

Experimental

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The FontFaceSet interface of the CSS Font Loading API manages the loading of font-faces and querying of their download status.It is available as document.fonts.

Properties

FontFaceSet.status Read only

Indicates the font-face's loading status. It will be one of 'loading' or 'loaded'.

FontFaceSet.ready Read only

Promise which resolves once font loading and layout operations have completed.

Events

FontFaceSet.onloading

An EventListener called whenever an event of type loading is fired, indicating a font-face set has started loading.

FontFaceSet.onloadingdone

An EventListener called whenever an event of type loadingdone is fired, indicating that a font face set has finished loading.

FontFaceSet.onloadingerror

An EventListener called whenever an event of type loadingerror is fired, indicating that an error occurred whilst loading a font-face set.

Methods

FontFaceSet.add()

Adds a font to the font set.

FontFaceSet.check()

A Boolean that indicates whether a font is loaded, but doesn't initiate a load when it isn't.

FontFaceSet.clear()

Removes all manually-added fonts from the font set. CSS-connected fonts are unaffected.

FontFaceSet.delete()

Removes a manually-added font from the font set. CSS-connected fonts are unaffected.

FontFaceSet.load()

Returns a Promise which resolves to a list of font-faces for a requested font.

Specifications

Browser compatibility

BCD tables only load in the browser