FontFace

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

* Some parts of this feature may have varying levels of support.

Экспериментальная возможность: Это экспериментальная технология
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.

Интерфейс FontFace представляет единый используемый шрифт. Он позволяет контролировать источник шрифта, являющийся URL-адресом внешнего ресурса или буфера; а также контролировать момент загрузки шрифта и его текущее состояние.

Конструктор

FontFace()

Создаёт и возвращает новый объект FontFace, созданный из внешнего ресурса, описанного URL-адресом или из ArrayBuffer.

Свойства

Этот интерфейс не наследует свойства.

FontFace.display

CSSOMString определяет способ отображения шрифта, основываясь на информации о статусе его загрузки и готовности к использованию.

FontFace.family

CSSOMString получает или устанавливает семейство шрифта. Эквивалентен дескриптору font-family.

FontFace.featureSettings

CSSOMString получает или устанавливает редко используемые возможности шрифта. Эквивалентен дескриптору font-feature-settings.

FontFace.loaded Только для чтения

Возвращает Promise, которое выполняется для текущего объекта FontFace, когда специфичный шрифт, указанный в конструкторе объекта, завершает загрузку, либо отклоняется с помощью SyntaxError.

FontFace.status Только для чтения

Возвращает перечисляемое значение, указывающее на состояние шрифта : "unloaded", "loading", "loaded", или "error".

FontFace.stretch

CSSOMString получает или устанавливает свойство растягивания шрифта. Эквивалентен дескриптору font-stretch.

FontFace.style

CSSOMString получает или устанавливает стиль шрифта. Эквивалентен дескриптору font-style.

FontFace.unicodeRange

CSSOMString получает или устанавливает диапазон точек кодирования Юникод, охватывающих шрифт. Эквивалентен дескриптору unicode-range.

FontFace.variant

CSSOMString получает или устанавливает вариант шрифта. Эквивалентен дескриптору font-variant.

FontFace.weight

CSSOMString содержит толщину шрифта. Эквивалентен дескриптору font-weight.

Методы

Этот интерфейс не наследует методы.

FontFace.load()

Загружает шрифт, основываясь на переданных требованиях конструктора текущего объекта, включая расположение или ресурсный буфер, и возвращает Promise, которое выполняется для текущего объекта FontFace.

Спецификации

Specification
CSS Font Loading Module Level 3
# fontface-interface

Совместимость с браузерами

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
FontFace
FontFace() constructor
ascentOverride
descentOverride
display
family
featureSettings
lineGapOverride
load
loaded
status
stretch
style
unicodeRange
variant
Non-standard
variationSettings
Experimental
weight
Available in workers

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.