Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

format() dans le descripteur src de @font-face

`format()` indique le format attendu d’une source de police donnée. Le navigateur peut ainsi ignorer une source non prise en charge sans récupérer ses données.

Version : 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

Dans @font-face, le descripteur src liste les sources de police par ordre de préférence, séparées par des virgules. L’indication facultative format() suit url() et ne concerne que cette URL. Elle ne suit pas local(), qui désigne une variante de police disponible localement.

format() prend un seul argument. La spécification privilégie les mots-clés comme format(woff2), mais accepte aussi des chaînes historiques équivalentes, comme format("woff2"), pour la rétrocompatibilité. La prise en charge de la syntaxe peut varier selon le navigateur. tech() indique séparément une technologie de police requise ; si les deux fonctions sont présentes, tech() se place après format().

Si le navigateur accepte la liste src, la spécification prévoit qu’il ignore les sources dont le format indiqué est inconnu ou non pris en charge, sans récupérer leurs données. Certains navigateurs peuvent au contraire rejeter tout le descripteur src lorsqu’ils rencontrent une indication qu’ils ne reconnaissent pas. La capacité à décoder WOFF2 ne garantit donc pas que le navigateur atteindra une source WOFF2 placée plus loin dans la liste. En l’absence d’indication de format, il examine les données lorsqu’il arrive à cette source. L’indication ne convertit pas le fichier et ne garantit ni la validité des données ni le succès de la récupération, par exemple si CORS la bloque.

Placez la source préférée en tête d’un seul descripteur src. Si elle est inutilisable, le navigateur passe à la prochaine source qu’il peut essayer. Prévoyez séparément une famille de secours dans la propriété font-family au cas où aucune source ne fonctionnerait.

Exemples

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

Résultat

Format demo
CktisFormatDemo failed to load; using monospace.

Les deux URL `data:` contiennent volontairement des données invalides. La déclaration `src` précédente conserve l’URL WOFF2 si le navigateur rejette la liste suivante lors de l’analyse syntaxique. Le chargement de `CktisFormatDemo` échoue et le texte de `.demo` est rendu avec `monospace`. Ce résultat ne montre pas quelles sources le navigateur a tenté de récupérer.

Leçons associées

  • CSS · Leçon 14 · Avancé · Version : 2
  • CSS · Leçon 15 · Avancé · Version : 2

Sources