Spec-Zone.ru › Web APIs

FontFace: метод load()

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

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

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

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

Метод load() интерфейса FontFace запрашивает и загружает шрифт, source которого был указан как URL. Он возвращает Promise, который разрешается текущим объектом FontFace.

Если source шрифта был указан как двоичные данные или свойство шрифта status отличается от unloaded, то этот метод ничего не делает.

Синтаксис

load()

Параметры

Нет.

Возвращаемое значение

Promise, который разрешается ссылкой на текущий объект FontFace при загрузке шрифта или отклоняется с NetworkError DOMException, если процесс загрузки завершился неудачно.

Исключения

NetworkError DOMException

Указывает, что попытка загрузить шрифт завершилась неудачно.

Примеры

В этом простом примере загружается шрифт и используется для отображения текста в элементе 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API