FontFace

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨январь 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.