WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

format() im src-Deskriptor von @font-face

`format()` gibt das erwartete Format einer einzelnen Schriftquelle an. So kann der Browser eine nicht unterstützte Quelle überspringen, ohne ihre Daten abzurufen.

Version: Current CSS specifications; browser support varies by feature

Syntax

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

In @font-face enthält der Deskriptor src eine kommagetrennte Liste von Schriftquellen in der gewünschten Reihenfolge. Der optionale Hinweis format() steht nach url() und gilt nur für diese URL. Nach local(), das einen lokal verfügbaren Schriftschnitt benennt, steht er nicht.

format() nimmt ein Argument entgegen. Die Spezifikation bevorzugt Schlüsselwörter wie format(woff2), akzeptiert aus Gründen der Abwärtskompatibilität aber auch gleichwertige ältere Zeichenfolgen wie format("woff2"). Die Unterstützung der Syntax kann je nach Browser variieren. tech() gibt separat eine benötigte Schrifttechnologie an. Werden beide Funktionen verwendet, steht tech() nach format().

Wenn der Browser die src-Liste akzeptiert, überspringt er laut Spezifikation Quellen mit unbekanntem oder nicht unterstütztem Formathinweis, ohne ihre Daten abzurufen. Manche Browser können bei einem unbekannten Hinweis stattdessen den gesamten src-Deskriptor verwerfen. Dass ein Browser WOFF2 dekodieren kann, garantiert daher nicht, dass er eine weiter hinten in der Liste stehende WOFF2-Quelle erreicht. Ohne Formathinweis prüft er die Daten, sobald die betreffende Quelle an der Reihe ist. Der Hinweis konvertiert die Datei nicht und garantiert weder gültige Daten noch einen erfolgreichen Abruf, etwa wenn CORS den Abruf blockiert.

Setze die bevorzugte Quelle in einem einzigen src-Deskriptor an die erste Stelle. Ist sie nicht nutzbar, geht der Browser zur nächsten Quelle über, die er ausprobieren kann. Gib zusätzlich in der Eigenschaft font-family eine Ersatzschriftfamilie an, falls keine Quelle funktioniert.

Beispiele

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

Ergebnis

Format demo
CktisFormatDemo failed to load; using monospace.

Beide `data:`-URLs enthalten absichtlich ungültige Daten. Die vorherige `src`-Deklaration hält die WOFF2-URL verfügbar, falls der Browser die nachfolgende Liste bei der Syntaxanalyse verwirft. `CktisFormatDemo` lässt sich nicht laden, und der Text in `.demo` wird mit `monospace` dargestellt. Das Ergebnis zeigt nicht, welche Quellen der Browser abzurufen versucht hat.

Zugehörige Lektionen

  • CSS · Lektion 14 · Fortgeschritten · Version: 2
  • CSS · Lektion 15 · Fortgeschritten · Version: 2

Quellen