font-variant

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

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 (première révision), 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;


  
    Difficult waffles
    
      
        0O
      
      
        3.14
      
      
        2.71

@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 détaillées correspondantes

Cette propriété est une propriété raccourcie 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: unset;

Valeurs

normal: Définit une police normale ; chacune des propriétés individuelles a une valeur initiale de normal. Les propriétés détaillées de font-variant sont : font-variant-caps, font-variant-numeric, font-variant-alternates, font-variant-ligatures et font-variant-east-asian.
none: Définit une valeur de none pour font-variant-ligatures et une valeur de normal pour les autres propriétés, leur valeur initiale.
, , ,: 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-alternates.
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.
, , , 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.
, , 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.

Définition formelle

Valeur initiale	`normal`
Applicabilité	all elements and text. S'applique aussi à `::first-letter` et `::first-line`.
Héritée	oui
Valeur calculée	comme spécifié
Type d'animation	discrète

Syntaxe formelle

font-variant = 
  normal                                              |
  none                                                |
  [ [  ||  ||  ||  ] || [ small-caps | all-small-caps | petite-caps | all-petite-caps | unicase | titling-caps ] || [ stylistic(  ) || historical-forms || styleset( # ) || character-variant( # ) || swash(  ) || ornaments(  ) || annotation(  ) ] || [  ||  ||  || ordinal || slashed-zero ] || [  ||  || ruby ] || [ sub | super ] || [ text | emoji | unicode ] ]  

 = 
  common-ligatures     |
  no-common-ligatures  

 = 
  discretionary-ligatures     |
  no-discretionary-ligatures  

 = 
  historical-ligatures     |
  no-historical-ligatures  

 = 
  contextual     |
  no-contextual  

 = 
    

 = 
  lining-nums    |
  oldstyle-nums  

 = 
  proportional-nums  |
  tabular-nums       

 = 
  diagonal-fractions  |
  stacked-fractions   

 = 
  jis78        |
  jis83        |
  jis90        |
  jis04        |
  simplified   |
  traditional  

 = 
  full-width          |
  proportional-width

Exemples

Utiliser la valeur `small-caps` de `font-variant`

HTML

html

Firefox normal
Firefox petit

CSS

css

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

Résultat

Spécifications

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