Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / CSS

format() v deskriptoru src pravidla @font-face

`format()` udává očekávaný formát jednoho zdroje písma. Prohlížeč tak může přeskočit nepodporovaný zdroj, aniž by stahoval jeho data.

Verze: Current CSS specifications; browser support varies by feature

Syntaxe

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

V pravidle @font-face obsahuje deskriptor src seznam zdrojů písma v pořadí podle preference, oddělených čárkami. Volitelná informace format() následuje za url() a platí jen pro tuto adresu. Nepřidává se za local(), které označuje místně dostupný řez písma.

format() přijímá jeden argument. Specifikace upřednostňuje klíčová slova jako format(woff2), kvůli zpětné kompatibilitě však přijímá i rovnocenné starší řetězce jako format("woff2"). Podpora syntaxe se může lišit podle prohlížeče. Samostatná funkce tech() uvádí požadovanou technologii písma; použijete-li obě funkce, tech() patří za format().

Pokud prohlížeč seznam src přijme, podle specifikace přeskočí zdroje s neznámým nebo nepodporovaným uvedeným formátem, aniž by stáhl jejich data. Některé prohlížeče ale mohou při neznámém údaji o formátu odmítnout celý deskriptor src. Samotná schopnost dekódovat WOFF2 tedy nezaručuje, že se prohlížeč dostane ke zdroji WOFF2 později v seznamu. Není-li formát uveden, prozkoumá data, jakmile na zdroj přijde řada. Tato informace soubor nepřevádí a nezaručuje platnost dat ani úspěch stažení, například pokud stažení zablokuje CORS.

Preferovaný zdroj uveďte jako první v jediném deskriptoru src. Pokud jej nelze použít, prohlížeč přejde k dalšímu zdroji, který může vyzkoušet. Pro případ, že žádný zdroj nefunguje, uveďte zvlášť náhradní rodinu písma ve vlastnosti font-family.

Příklady

<!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>

Výsledek

Format demo
CktisFormatDemo failed to load; using monospace.

Obě adresy `data:` záměrně obsahují neplatná data. Předchozí deklarace `src` ponechává adresu WOFF2 k dispozici pro případ, že prohlížeč pozdější seznam při analýze syntaxe odmítne. Písmo `CktisFormatDemo` se nenačte a text v `.demo` se vykreslí pomocí `monospace`. Výsledek neukazuje, které zdroje se prohlížeč pokusil stáhnout.

Související lekce

  • CSS · Lekce 14 · Pokročilá · Verze: 2
  • CSS · Lekce 15 · Pokročilá · Verze: 2

Zdroje