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

Propriété CSS font-variant

Baseline
Large disponibilité

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

La propriété raccourcie CSS font-variant permet de définir tous les paramètres typographiques pour une police de caractères.

On peut aussi utiliser les valeurs de la propriété font-variant définies avec la spécification CSS de niveau 2.1, normal ou small-caps, en utilisant la propriété raccourcie font.

Exemple interactif

font-variant: normal;
font-variant: no-common-ligatures proportional-nums;
font-variant: common-ligatures tabular-nums;
font-variant: small-caps slashed-zero;
<section id="default-example">
  <div id="example-element">
    <p>La difficulté des gaufres</p>
    <table>
      <tr>
        <td><span class="tabular">0O</span></td>
      </tr>
      <tr>
        <td><span class="tabular">3.14</span></td>
      </tr>
      <tr>
        <td><span class="tabular">2.71</span></td>
      </tr>
    </table>
  </div>
</section>
@font-face {
  font-family: "Fira Sans";
  src:
    local("FiraSans-Regular"),
    url("/shared-assets/fonts/FiraSans-Regular.woff2") format("woff2");
  font-weight: normal;
  font-style: normal;
}

section {
  font-family: "Fira Sans", sans-serif;
  margin-top: 10px;
  font-size: 1.5em;
}

#example-element table {
  margin-left: auto;
  margin-right: auto;
}

.tabular {
  border: 1px solid;
}

Propriétés constitutives

Cette propriété est une abréviation pour les propriétés CSS suivantes :

Syntaxe

css
font-variant: small-caps;
font-variant: common-ligatures small-caps;

/* Valeurs globales */
font-variant: inherit;
font-variant: initial;
font-variant: revert;
font-variant: revert-layer;
font-variant: unset;

Valeurs

Cette propriété se définit comme une liste de valeurs séparées par des espaces parmi les valeurs suivantes :

normal

Définit une police normale. Chaque propriété individuelle a une valeur initiale de normal.

none

Définit la valeur de font-variant-ligatures à none et la valeur des autres propriétés individuelles à normal, leur valeur initiale.

<common-lig-values>, <discretionary-lig-values>, <historical-lig-values>, <contextual-alt-values>

Définit les mots-clés relatifs à la propriété détaillée font-variant-ligatures. Les valeurs possibles sont : common-ligatures, no-common-ligatures, discretionary-ligatures, no-discretionary-ligatures, historical-ligatures, no-historical-ligatures, contextual et no-contextual.

stylistic(), historical-forms, styleset(), character-variant(), swash(), ornaments(), annotation()

Définit les mots-clés et fonctions relatifs à la propriété détaillée font-variant-ligatures.

small-caps, all-small-caps, petite-caps, all-petite-caps, unicase, titling-caps

Définit les mots-clés et fonctions relatifs à la propriété détaillée font-variant-caps. La valeur small-caps est la seule variante de police non normal valide dans la propriété raccourcie font.

<numeric-figure-values>, <numeric-spacing-values>, <numeric-fraction-values>, ordinal, slashed-zero

Définit les mots-clés relatifs à la propriété détaillée font-variant-numeric. Les valeurs possibles sont : lining-nums, oldstyle-nums, proportional-nums, tabular-nums, diagonal-fractions, stacked-fractions, ordinal et slashed-zero.

<east-asian-variant-values>, <east-asian-width-values>, ruby

Définit les mots-clés relatifs à la propriété détaillée font-variant-east-asian. Les valeurs possibles sont : jis78, jis83, jis90, jis04, simplified, traditional, full-width, proportional-width et ruby.

sub, super

Définit les mots-clés et fonctions relatifs à la propriété détaillée font-variant-position.

text, emoji, unicode

Définit les mots-clés et fonctions relatifs à la propriété détaillée font-variant-emoji.

Définition formelle

Valeur initialenormal
Applicabilitétous les éléments et le texte. S'applique aussi à ::first-letter et ::first-line.
Héritéeoui
Valeur calculéecomme défini
Type d'animationdiscrète

Syntaxe formelle

font-variant = 
normal |
none |
[ [ <common-lig-values> || <discretionary-lig-values> || <historical-lig-values> || <contextual-alt-values> ] || [ small-caps | all-small-caps | petite-caps | all-petite-caps | unicase | titling-caps ] || [ stylistic( <font-feature-value-name> ) || historical-forms || styleset( <font-feature-value-name># ) || character-variant( <font-feature-value-name># ) || swash( <font-feature-value-name> ) || ornaments( <font-feature-value-name> ) || annotation( <font-feature-value-name> ) ] || [ <numeric-figure-values> || <numeric-spacing-values> || <numeric-fraction-values> || ordinal || slashed-zero ] || [ <east-asian-variant-values> || <east-asian-width-values> || ruby ] || [ sub | super ] || [ text | emoji | unicode ] ]

<common-lig-values> =
common-ligatures |
no-common-ligatures

<discretionary-lig-values> =
discretionary-ligatures |
no-discretionary-ligatures

<historical-lig-values> =
historical-ligatures |
no-historical-ligatures

<contextual-alt-values> =
contextual |
no-contextual

<font-feature-value-name> =
<ident>

<numeric-figure-values> =
lining-nums |
oldstyle-nums

<numeric-spacing-values> =
proportional-nums |
tabular-nums

<numeric-fraction-values> =
diagonal-fractions |
stacked-fractions

<east-asian-variant-values> =
jis78 |
jis83 |
jis90 |
jis04 |
simplified |
traditional

<east-asian-width-values> =
full-width |
proportional-width

Exemples

Utiliser la valeur small-caps de font-variant

HTML

html
<p class="normal">Firefox normal&nbsp;!</p>
<p class="small">Firefox petit&nbsp;!</p>

CSS

css
p.normal {
  font-variant: normal;
}
p.small {
  font-variant: small-caps;
}

Résultat

Spécifications

Spécification
CSS Fonts Module Level 4
# font-variant-prop
Scalable Vector Graphics (SVG) 2
# FontVariantProperty

Compatibilité des navigateurs

Voir aussi