font-variant
============

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

Propriétés détaillées correspondantes
-------------------------------------

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

* `font-variant-alternates`
* `font-variant-caps`
* `font-variant-east-asian`
* `font-variant-ligatures`
* `font-variant-numeric`
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.

`<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-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`.

`<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`.

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                                                |  
  [ [ <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( <feature-value-name> ) || historical-forms || styleset( <feature-value-name># ) || character-variant( <feature-value-name># ) || swash( <feature-value-name> ) || ornaments( <feature-value-name> ) || annotation( <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    
  
<feature-value-name> =   
  <ident> (en-US)    
  
<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</p>
<p class="small">Firefox petit</p>
```


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

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `text-transform`
* `text-combine-upright`
* `text-orientation`