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.

Learn more
See full compatibility

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

Интерфейс 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

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

Help improve MDN

Learn how to contribute

This page was last modified on 6 янв. 2024 г. by MDN contributors.

View this page on GitHub • Report a problem with this content