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

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