База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / CSS

format() в дескриптора src на правилото @font-face

`format()` посочва очаквания формат на отделен източник на шрифт, за да може браузърът да пропусне неподдържан източник, без да изтегля данните му.

Версия: Current CSS specifications; browser support varies by feature

Синтаксис

src = <font-src>#
<font-src> = <url> [ format( <font-format> ) ]? [ tech( <font-tech># ) ]? | local( <font-family-name> )
<font-format> = <string> | collection | embedded-opentype | opentype | svg | truetype | woff | woff2

В правилото @font-face дескрипторът src изброява източниците на шрифта по ред на предпочитание, разделени със запетаи. Незадължителното указание format() стои след url() и се отнася само за този URL адрес. Не се поставя след local(), което посочва локално налична разновидност на шрифта.

format() приема един аргумент. Спецификацията предпочита ключови думи като format(woff2), но за обратна съвместимост допуска и равностойни по-стари низове като format("woff2"). Поддръжката на синтаксиса може да се различава между браузърите. tech() е отделно указание за необходима шрифтова технология; ако използвате и двете функции, поставете tech() след format().

Ако браузърът приеме списъка src, според спецификацията той пропуска източниците с посочен непознат или неподдържан формат, без да изтегля данните им. Някои браузъри обаче може да отхвърлят целия дескриптор src, когато срещнат неразпознато указание. Възможността за декодиране на WOFF2 сама по себе си не гарантира, че браузърът ще стигне до източник във формат WOFF2 по-нататък в списъка. Ако форматът не е посочен, браузърът проверява данните, когато стигне до съответния източник. Указанието не преобразува файла и не гарантира валидни данни или успешно изтегляне, например ако CORS го блокира.

Поставете предпочитания източник на първо място в един дескриптор src. Ако не може да го използва, браузърът преминава към следващия източник, който може да опита. Отделно посочете резервно семейство шрифтове в свойството font-family, в случай че никой източник не проработи.

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Font format hint demo</title>
<style>
  @font-face {
    font-family: "CktisFormatDemo";
    /* Keep the WOFF2 URL available if the next declaration is invalid. */
    src: url("data:font/woff2,second-invalid-payload") format("woff2");
    src: url("data:font/woff2,first-invalid-payload") format("cktis-unknown-format"),
         url("data:font/woff2,second-invalid-payload") format("woff2");
  }

  .demo {
    font-family: "CktisFormatDemo", monospace;
  }
</style>
<body>
<div class="demo">Format demo</div>
<div id="result" role="status"></div>
<script type="module">
  const demo = document.querySelector('.demo');
  const result = document.querySelector('#result');
  const src = document.styleSheets[0].cssRules[0].style.getPropertyValue('src');

  const loadFailed = await document.fonts.load('16px "CktisFormatDemo"', demo.textContent)
    .then(() => false, () => true);
  await document.fonts.ready;

  const families = getComputedStyle(demo).fontFamily.split(',').map(name => name.trim());
  const fallbackIsMonospace = families.length === 2 &&
    families[0].replace(/["']/g, '') === 'CktisFormatDemo' &&
    families[1] === 'monospace';

  result.textContent = src.includes('second-invalid-payload') && loadFailed && fallbackIsMonospace
    ? 'CktisFormatDemo failed to load; using monospace.'
    : 'Unexpected result: check the src descriptor, font load, and fallback family.';
</script>
</body>
</html>

Резултат

Format demo
CktisFormatDemo failed to load; using monospace.

И двата URL адреса `data:` умишлено съдържат невалидни данни. Предходната декларация `src` запазва URL адреса за WOFF2, ако браузърът отхвърли следващия списък при синтактичния анализ. Шрифтът `CktisFormatDemo` не се зарежда и текстът в `.demo` се изобразява с шрифт от семейството `monospace`. Този резултат не показва кои източници браузърът се е опитал да изтегли.

Свързани уроци

  • CSS · Урок 14 · Напреднало · Версия: 2
  • CSS · Урок 15 · Напреднало · Версия: 2

Източници