Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Document : propriété fonts

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis janvier 2020.

La propriété fonts de l'interface Document retourne l'interface FontFaceSet du document.

Cette fonctionnalité fait partie de l'API de chargement des polices CSS.

Valeur

La valeur retournée est l'interface FontFaceSet du document. L'interface FontFaceSet est utile pour charger de nouvelles polices, vérifier l'état des polices précédemment chargées, etc.

Exemples

Effectuer une opération après le chargement des polices

js
document.fonts.ready.then((fontFaceSet) => {
  // Toute opération qui doit être effectuée uniquement après que toutes
  // les polices utilisées ont terminé leur chargement peut être placée
  // ici.
  const fontFaces = [...fontFaceSet];
  console.log(fontFaces);
  // certaines polices peuvent encore être non chargées si elles ne sont
  // pas utilisées sur le site
  console.log(fontFaces.map((f) => f.status));
});

La promesse se résout lorsque les opérations de chargement et de mise en page de toutes les polices utilisées sont terminées. L'ensemble des polices utilisées peut être différent de l'ensemble des polices déclarées, par exemple, si des polices optionnelles (c'est-à-dire des polices déclarées via font-display: optional) n'ont pas pu être chargées à temps.

Spécifications

Specification
CSS Font Loading Module Level 3
# FontFaceSet-interface

Compatibilité des navigateurs

Voir aussi