FontFaceSet

Базовая поддержка Широко доступно *

Эта функция хорошо поддерживается многими устройствами и версиями браузеров. Она доступна в браузерах с января 2020 года.

* Некоторые части этой функции могут иметь различный уровень поддержки.

Примечание: Эта функция доступна в Web Workers.

Интерфейс FontFaceSet API загрузки шрифтов CSS управляет загрузкой начертаний шрифтов и запросом их статуса загрузки.

Экземпляр FontFaceSet является объектом, похожим на Set, который может содержать упорядоченный набор объектов FontFace.

Это свойство доступно как Document.fonts или self.fonts в web workers.

Свойства экземпляра

FontFaceSet.status Только для чтения: Указывает статус загрузки начертания шрифта. Он будет одним из значений 'loading' или 'loaded'.
FontFaceSet.ready Только для чтения: Promise, который разрешается после завершения операций загрузки и вывода шрифтов.
FontFaceSet.size Только для чтения: Возвращает количество значений в FontFaceSet.

События

loading: Срабатывает, когда набор шрифтов начал загружаться.
loadingdone: Срабатывает, когда набор шрифтов завершил загрузку.
loadingerror: Срабатывает, когда при загрузке набора шрифтов произошла ошибка.

Методы экземпляра

FontFaceSet.add(): Добавляет шрифт в набор шрифтов.
FontFaceSet.check(): Логическое значение, указывающее, загружен ли шрифт, но не инициирует загрузку, если он не загружен.
FontFaceSet.clear(): Удаляет все вручную добавленные шрифты из набора шрифтов. Шрифты, связанные с CSS, не затрагиваются.
FontFaceSet.delete(): Удаляет вручную добавленный шрифт из набора шрифтов. Шрифты, связанные с CSS, не затрагиваются.
FontFaceSet.entries(): Возвращает новый итератор со значениями для каждого элемента в FontFaceSet в порядке вставки.
FontFaceSet.forEach(): Выполняет предоставленную функцию для каждого значения в объекте FontFaceSet.
FontFaceSet.has(): Возвращает Boolean, определяющий, присутствует ли элемент с заданным значением.
FontFaceSet.keys(): Псевдоним для FontFaceSet.values().
FontFaceSet.load(): Возвращает Promise, который разрешается в список начертаний шрифтов для запрошенного шрифта.
FontFaceSet.values(): Возвращает новый объект итератора, который возвращает значения для каждого элемента в объекте FontFaceSet в порядке вставки.

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

Спецификация
CSS Font Loading Module Level 3 # FontFaceSet-interface

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

	Настольный					Мобильный
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android
`@@iterator`	48	79	41	35	10	48	41	35	10	5.0	48
`FontFaceSet`	Нет	Нет	Нет	Нет	10 Будет удалено, см. ошибка 276794	Нет	Нет	Нет	10 Будет удалено, см. ошибка 276794	Нет	Нет
`FontFaceSet`	35 Chrome не предоставляет интерфейс `FontFaceSet` напрямую, он доступен только через `Document.fonts` или `WorkerGlobalScope.fonts`.	79 Edge не предоставляет интерфейс `FontFaceSet` напрямую, он доступен только через `Document.fonts` или `WorkerGlobalScope.fonts`.	41	22 Opera не предоставляет интерфейс `FontFaceSet` напрямую, он доступен только через `Document.fonts` или `WorkerGlobalScope.fonts`.	10	35 Chrome Android не предоставляет интерфейс `FontFaceSet` напрямую, он доступен только через `Document.fonts` или `WorkerGlobalScope.fonts`.	41	22 Opera Android не предоставляет интерфейс `FontFaceSet` напрямую, он доступен только через `Document.fonts` или `WorkerGlobalScope.fonts`.	10	3.0 Samsung Internet не предоставляет интерфейс `FontFaceSet` напрямую, он доступен только через `Document.fonts` или `WorkerGlobalScope.fonts`.	37 WebView Android не предоставляет интерфейс `FontFaceSet` напрямую, он доступен только через `Document.fonts` или `WorkerGlobalScope.fonts`.
`add`	35	79	41	22	10	35	41	22	10	3.0	37
`check`	120 35 До версии 120 этот метод возвращал `false` вместо `true` для несуществующих или локально установленных шрифтов. См. ошибка 40893726.	120 79 До версии 120 этот метод возвращал `false` вместо `true` для несуществующих или локально установленных шрифтов. См. ошибка 40893726.	41	106 22 До версии 106 этот метод возвращал `false` вместо `true` для несуществующих или локально установленных шрифтов. См. ошибка 40893726.	10	120 35 До версии 120 этот метод возвращал `false` вместо `true` для несуществующих или локально установленных шрифтов. См. ошибка 40893726.	41	80 22 До версии 80 этот метод возвращал `false` вместо `true` для несуществующих или локально установленных шрифтов. См. ошибка 40893726.	10	25.0 3.0 До версии 25.0 этот метод возвращал `false` вместо `true` для несуществующих или локально установленных шрифтов. См. ошибка 40893726.	120 37 До версии 120 этот метод возвращал `false` вместо `true` для несуществующих или локально установленных шрифтов. См. ошибка 40893726.
`clear`	35	79	41	22	10	35	41	22	10	3.0	37
`delete`	35	79	41	22	10	35	41	22	10	3.0	37
`entries`	48	79	41	35	10	48	41	35	10	5.0	48
`forEach`	35	79	41	22	10	35	41	22	10	3.0	37
`has`	35	79	41	22	10	35	41	22	10	3.0	37
`keys`	48	79	41	35	10	48	41	35	10	5.0	48
`load`	35	79	41	22	10	35	41	22	10	3.0	37
`loading_event`	35	79	41	22	10	35	41	22	10	3.0	37
`loadingdone_event`	35	79	41	22	10	35	41	22	10	3.0	37
`loadingerror_event`	35	79	41	22	10	35	41	22	10	3.0	37
`ready`	35	79	41	22	10	35	41	22	10	3.0	37

`size`	35	79	41	22	10	35	41	22	10	3.0	37
`status`	35	79	41	22	10	35	41	22	10	3.0	37
`values`	48	79	41	35	10	48	41	35	10	5.0	48
`worker_support`	69	79	105	56	Нет	69	105	48	Нет	10.0	69

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FontFaceSet