FontFace: метод load()
Базовая линия Широко доступна
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2020 года.
Примечание: Эта функция доступна в Web Workers.
Метод load() интерфейса FontFace запрашивает и загружает шрифт, source которого был указан как URL. Он возвращает Promise, который разрешается текущим объектом FontFace.
Если source шрифта был указан как двоичные данные или свойство шрифта status отличается от unloaded, то этот метод ничего не делает.
Синтаксис
load()
Параметры
Нет.
Возвращаемое значение
Promise, который разрешается ссылкой на текущий объект FontFace при загрузке шрифта или отклоняется с NetworkError DOMException, если процесс загрузки завершился неудачно.
Исключения
-
NetworkErrorDOMException -
Указывает, что попытка загрузить шрифт завершилась неудачно.
Примеры
В этом простом примере загружается шрифт и используется для отображения текста в элементе canvas (с id js-canvas).
const canvas = document.getElementById("js-canvas");
// load the "Bitter" font from Google Fonts
const fontFile = new FontFace(
"FontFamily Style Bitter",
"url(https://fonts.gstatic.com/s/bitter/v7/HEpP8tJXlWaYHimsnXgfCOvvDin1pK8aKteLpeZ5c0A.woff2)",
);
document.fonts.add(fontFile);
fontFile.load().then(
() => {
// font loaded successfully!
canvas.width = 650;
canvas.height = 100;
const ctx = canvas.getContext("2d");
ctx.font = '36px "FontFamily Style Bitter"';
ctx.fillText("Bitter font loaded", 20, 50);
},
(err) => {
console.error(err);
},
);
Спецификации
| Спецификация |
|---|
| CSS Font Loading Module Level 3 # font-face-load |
Совместимость браузеров
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
load |
35 | 79 | 41 | 22 | 10 | 35 | 41 | 22 | 10 | 4.0 | 37 |
© 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/FontFace/load