@font-face

Syntaxe

@font-face {
  font-family: "Trickster";
  src:
    local("Trickster"),
    url("trickster-COLRv1.otf") format("opentype") tech(color-COLRv1),
    url("trickster-outline.otf") format("opentype"),
    url("trickster-outline.woff") format("woff");
}

Descripteurs

ascent-override

Définit la hauteur d'ascendante pour la police.

descent-override

Définit la hauteur de descendante pour la police.

font-display

Ce descripteur détermine la façon dont une police est affichée selon qu'elle a été téléchargée et/ou si elle est prête à être utilisée.

font-family

Ce descripteur définit un nom qui sera utilisé pour désigner cette police dans les différentes règles associées.

font-stretch

Une valeur font-stretch. Il est possible d'utiliser deux valeurs afin d'indiquer l'intervalle pris en charge par une police, par exemple : font-stretch: 50% 200%;.

font-style

Une valeur font-style. Il est possible d'utiliser deux valeurs afin d'indiquer l'intervalle pris en charge par une police, par exemple : font-style: oblique 20deg 50deg;.

font-weight

Une valeur font-weight. Il est possible d'utiliser deux valeurs afin d'indiquer l'intervalle pris en charge par une police, par exemple : font-weight: 100 400;.

font-feature-settings

Ce descripteur permet d'avoir un contrôle avancé sur les fonctionnalités typographiques relatives aux polices OpenType.

font-variation-settings

Ce descripteur permet d'avoir un contrôle de bas niveau sur les variations des polices OpenType et TrueType en indiquant les noms des axes et des fonctionnalités à faire varier.

line-gap-override

Définit la métrique pour l'interlignage de la police.

size-adjust

Définit un multiplicateur pour les contours des glyphes et les métriques associées à cette police. Cela permet de simplifier l'harmonisation de différentes polices lorsqu'elles sont affichées avec le même corps.

src

Indique les ressources à utiliser pour la police. La valeur est une liste de valeurs indiquant les ressources à tenter les unes après les autres. Chaque ressource est indiquée avec url() ou local(). C'est la première ressource de la liste qui est chargée correctement qui est utilisée. Les éléments situés après sont ignorés. Si plusieurs descripteurs src sont définis, seule la dernière règle déclarée capable de charger une ressource est appliquée.

unicode-range

L'intervalle des points de code Unicode pour lesquels la règle @font-face s'applique.

Description

On utilise fréquemment une combinaison de url() et de local() afin d'utiliser une version locale de la police si elle existe, puis de recourir au téléchargement d'un exemplaire distant si nécessaire.

Si la fonction local() est fournie, on lui passera un nom de police à rechercher sur l'appareil. Lorsque l'agent utilisateur trouve une correspondance, c'est cette police locale qui est utilisée. Sinon, le navigateur télécharge la police pointée par la fonction url() et l'utilise.

Les navigateurs tentent le téléchargement des ressources selon leur ordre de déclaration. Aussi, on écrira généralement local() avant url(). Les deux fonctions sont optionnelles et on peut donc avoir un bloc de règle contenant un ou plusieurs appels à local(), sans url(). On peut utiliser les fonctions format() ou tech() afin de cibler des polices plus spécifiques. Dans ce cas, on doit lister ces versions avant celles qui n'utilisent pas ces valeurs. En effet, dans le cas contraire, ce seraient les versions moins spécifiques qui seraient tentées et utilisées.

En permettant de fournir ses propres polices, @font-face permet de concevoir du contenu qui ne soit pas limité aux polices universellement disponibles. En permettant d'indiquer le nom d'une police locale, on peut personnaliser le contenu sans pour autant avoir besoin d'une connexion Internet.

La règle @ @font-face peut être utilisé au niveau le plus haut d'une feuille de styles et aussi au sein d'une règle de groupe conditionnelle.

Types MIME pour les polices

Notes

• Les polices utilisées sur le Web sont sujettes à la règle de même origine (les fichiers des polices doivent être sur le même domaine que la page qui les utilise), à moins que les paramètres de CORS soient utilisés afin de lever ces restrictions.

• @font-face ne peut pas être déclarée au sein d'un sélecteur CSS. L'exemple qui suit ne fonctionnera pas :

  css

  .className {
    @font-face {
      font-family: "MyHelvetica";
      src:
        local("Helvetica Neue Bold"), local("HelveticaNeue-Bold"),
        url("MgOpenModernaBold.ttf");
      font-weight: bold;
    }
  }
  

Syntaxe formelle

@font-face = 
  @font-face { <declaration-list> }  

Exemples

Indiquer une police téléchargeable

Dans cet exemple, on indique une police téléchargeable à utiliser et on l'applique à tout le corps du document :

HTML

<body>
  Il s'agit de Bitstream Vera Serif Bold.
</body>

CSS

@font-face {
  font-family: "Bitstream Vera Serif Bold";
  src: url("https://mdn.github.io/shared-assets/fonts/VeraSeBd.ttf");
}

body {
  font-family: "Bitstream Vera Serif Bold", serif;
}

Résultat

Indiquer des polices alternatives locales

Dans cet exemple, c'est l'exemplaire local de la police Helvetica Neue Bold qui est utilisé. Si elle n'est pas disponible sur l'appareil malgré les deux noms tentés, c'est une police distante avec le fichier MgOpenModernaBold.ttf qui est utilisée à la place :

@font-face {
  font-family: "MyHelvetica";
  src:
    local("Helvetica Neue Bold"), local("HelveticaNeue-Bold"),
    url("MgOpenModernaBold.ttf");
  font-weight: bold;
}

Spécifications

Compatibilité des navigateurs

Voir aussi

• À propos de WOFF
• Générateur @font-face de FontSquirrel ^(angl.)
• Le billet de blog De belles polices avec @font-face ^(angl.) de Mozilla (2009)
• Font Library ^(angl.), un site cataloguant des polices