Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

Syntaxe de définition des valeurs

La syntaxe de définition des valeurs CSS est une grammaire formelle qui définit les règles pour créer des règles CSS valides. En plus de ces règles, il peut y avoir des contraintes sémantiques (ex. un nombre doit être positif pour une propriété donnée).

La syntaxe de définition décrit les valeurs qui sont permises et les interactions entre ces valeurs. Un composant peut-être un mot-clé, un littéral, une valeur d'un type donné ou une autre propriété CSS.

Les types de composants

Les mots-clés

Les mots-clés génériques

Un mot-clé avec une signification prédéfinie, qui peut apparaître littéralement, sans apostrophes ou guillemets (ex. auto, smaller ou ease-in).

inherit et initial

Toutes propriétés CSS acceptent les mots-clés inherit et initial définies par la spécification CSS. Ces mots-clés ne sont pas listés dans la définition de la syntaxe et sont définies implicitement.

Les littéraux

En CSS, quelques caractères peuvent apparaître directement (ex. la barre oblique « / » ou la virgule « , ») et sont utilisés dans les définitions d'une propriété pour séparer ses composantes. La virgule est généralement utilisée pour séparer des valeurs d'une liste ou des paramètres d'une fonction. La barre oblique sépare des composantes sémantiquement différentes mais avec une syntaxe similaire. Généralement, la barre oblique est utilisée dans les propriétés raccourcies pour séparer les composants du même type mais qui sont associés aux différentes propriétés détaillées.

Ces deux symboles sont utilisés tels quels dans la définition d'une valeur.

Les types de donnée

Les types de donnée simples

Certains types de donnée sont utilisés pour différentes propriétés et sont définis pour l'ensemble des valeurs de la spécification. Ce sont les types de donnée simples et sont représentés par leur nom encadré par des chevrons (le type angle est donc représenté par : <angle>, <string>, et ainsi de suite).

Les types de donnée non terminaux

D'autres types de donnée, moins utilisés, sont appelés types de donné non-terminaux et sont également encadrés par des chevrons.

Les types de donnée non terminaux sont de deux sortes :

  • Les types de donnée qui utilisent le même nom qu'une propriété. Dans ce cas, le type de donnée correspond à l'ensemble des valeurs utilisé par la propriété. Ceux-ci sont généralement utilisés dans les définitions des propriétés raccourcies.
  • Les types de donnée dont le nom de n'est pas celui d'une propriété. Ces types de donnée sont très proches des types simples. La seule différence est l'emplacement de leur définition : dans ce cas, la définition est généralement très proche de la définition de la propriété qui les utilise.

Les combinateurs

Les crochets

Les crochets permettent de regrouper plusieurs entités, combinateurs et multiplicateurs pour les transformer en un seul composant. Cela permet de grouper les composants afin d' appliquer des règles de priorités (supérieures aux règles de précédence).

bold [ thin && <length> ]

Cet exemple pourra illustrer les valeurs suivantes :

  • bold thin 2vh
  • bold 0 thin
  • bold thin 3.5em

Mais ne correspondra pas à :

  • thin bold 3em car bold est juxtaposé au composant défini entre les crochets alors qu'il doit apparaître avant.

Juxtaposition

Si on place plusieurs mots-clés, littéraux ou types de donnée les uns à la suite des autres, séparés par un ou plusieurs blancs, cela indique que tous les composants sont obligatoires et doivent apparaître dans cet ordre.

bold <length> , thin

Cet exemple pourra illustrer les valeurs suivantes :

  • bold 1em, thin
  • bold 0, thin
  • bold 2.5cm, thin
  • bold 3vh, thin

Mais il ne correspondra pas à :

  • thin 1em, bold car les entités ne sont pas dans l'ordre indiqué
  • bold 1em thin car les entités sont obligatoires et la virgule qui est un littéral doit être présente
  • bold 0.5ms, thin car les valeurs ms ne sont pas des valeurs du type <length>

Double esperluette

Lorsqu'on sépare deux ou plusieurs composants par une double esperluette, cela signifie que toutes les entités sont obligatoires mais peuvent apparaître dans n'importe quel ordre.

bold && <length>

Cet exemple pourra illustrer les valeurs suivantes :

  • bold 1em
  • bold 0
  • 2.5cm bold
  • 3vh bold

Mais il ne correspondra pas à :

  • bold car les deux composants doivent apparaître.
  • bold 1em bold car les deux composants doivent apparaître exactement une fois.
Note : La juxtaposition est prioritaire par rapport à la double esperluette. bold thin && <length> est donc équivalent à [ bold thin ] && <length>. Il décrit bold thin <length> ou <length> bold thin mais pas bold <length> thin.

Double barre

Lorsque deux ou plusieurs composants sont séparés par une double barre verticale ||. Cela signifie qu'au moins un composant doit être présent et qu'ils peuvent apparaître dans n'importe quel ordre. Généralement, ceci est utilisé pour définir les différentes valeurs d'une propriété raccourcie.

<'border-width'> || <'border-style'> || <'border-color'>

Cet exemple pourra illustrer les valeurs suivantes :

  • 1em solid blue
  • blue 1em
  • solid 1px yellow

Mais il ne correspondra pas à :

  • blue yellow car le composant doit apparaître au plus une fois.
  • bold car le mot-clé n'est pas permis pour aucune valeur de l'entité.
Note : La double esperluette est prioritaire par rapport à la double barre. bold || thin && <length> est équivalent à bold || [ thin && <length> ] qui décrit bold, thin <length>, bold thin <length>, ou thin <length> bold mais pas <length> bold thin car bold, s'il est présent doit apparaître avant thin && <length>.

La barre verticale

Lorsqu'on sépare deux entités par une barre verticale. Cela signifie que les différentes options sont exclusives : seule une des options doit être présente. Généralement, cela permet de séparer différents mots-clés possible.

<percentage> | <length> | left | center | right | top | bottom

Cet exemple pourra illustrer les valeurs suivantes :

  • 3%
  • 0
  • 3.5em
  • left
  • center
  • right
  • top
  • bottom

Mais il ne correspondra pas à :

  • center 3% car seul un seul des composants doit être présent.
  • 3em 4.5em car un composant doit être présent au plus une seule fois.

Note : La double barre verticale est prioritaire par rapport à la simple barre verticale. Ainsi bold | thin || <length> est équivalent à bold | [ thin || <length> ] qui décrit bold, thin, <length>, <length> thin ou thin <length> mais pas bold <length> car seule entité peut être présente.

Les multiplicateurs

Un multiplicateur est un signe qui indique nombre de fois qu'une entité peut être répétée. Sans aucun multiplicateur, une entité doit apparaître exactement une fois.

L'astérisque (*)

L'astérisque indique qu'une entité peut apparaître zéro, une ou plusieurs fois.

bold smaller*

Cet exemple pourra illustrer les valeurs suivantes :

  • bold
  • bold smaller
  • bold smaller smaller
  • bold smaller smaller smaller and so on.

Mais il ne correspondra pas à :

  • smaller car bold est juxtaposé et doit apparaître avant le mot-clé smaller.

Plus (+)

Le multiplicateur « plus » indique que l'entité peut apparaître une ou plusieurs fois.

bold smaller+

Cet exemple pourra illustrer les valeurs suivantes :

  • bold smaller
  • bold smaller smaller
  • bold smaller smaller smaller and so on.

Mais il ne correspondra pas à :

  • bold car smaller doit apparaître au moins une fois
  • smaller car bold est juxtaposé et doit apparaitre avant smaller.

Le point d'interrogation (?)

Le point d'interrogation indique que l'entité est optionnelle et doit apparaître zéro ou une fois.

bold smaller?

Cet exemple pourra illustrer les valeurs suivantes :

  • bold
  • bold smaller

Mais il ne correspondra pas à :

  • bold smaller smaller car smaller doit apparaître au plus une fois
  • smaller car bold est juxtaposé et doit apparaître avant le mot-clé smaller s'il est présent.

Les accolades ({ })

Les accolades encadrent deux entiers A et B, séparés par une virgule et indiquent que l'entité doit apparaître au moins A fois et au plus B fois.

bold smaller{1,3}

Cet exemple pourra illustrer les valeurs suivantes :

  • bold smaller
  • bold smaller smaller
  • bold smaller smaller smaller

Mais il ne correspondra pas à :

  • bold car smaller doit apparaître au moins une fois.
  • bold smaller smaller smaller smaller car smaller doit apparaître au plus trois fois.
  • smaller car bold est juxtaposé et doit apparaître avant le mot-clé smaller.

Dièse (#)

Le symbole dièse indique qu'une entité doit être répétée une ou plusieurs fois et que chaque occurrence est séparée par une virgule.

bold smaller#

Cet exemple pourra illustrer les valeurs suivantes :

  • bold smaller
  • bold smaller, smaller
  • bold smaller, smaller, smaller and so on.

Mais il ne correspondra pas à :

  • bold car smaller doit apparaître au moins une fois.
  • bold smaller smaller smaller car les différentes occurrences de smaller doivent être séparées par des virgules.
  • smaller car bold est juxtaposé et doit apparaître avant toute occurrence du mot-clé smaller.

Récapitulatif

Signe Nom Description Exemple
Combinateurs
  Juxtaposition Les composants sont obligatoires et doivent apparaître dans cet ordre. solid <length>
&& Double esperluette Les composants sont obligatoires mais peuvent apparaître dans n'importe quel ordre. <length> && <string>
|| Double barre Au moins un des composants doit être présent et ils peuvent apparaître dans n'importe quel ordre. <'border-image-outset'> || <'border-image-slice'>
| Barre simple Un et un seul des composants doit être présent. smaller | small | normal | big | bigger
[ ] Crochets Les composants peuvent être groupés pour avoir une priorité supérieure aux règles précédentes. bold [ thin && <length> ]
Multiplicateurs
  Aucun multiplicateur Exactement 1 fois. solid
* Astérisque 0 ou plus. bold smaller*
+ Signe plus 1 ou plus. bold smaller+
? Point d'interrogation 0 ou 1 fois (autrement dit, la valeur est optionnelle) bold smaller?
{A,B} Accolades Au moins A fois et au plus B fois. bold smaller{1,3}
# Dièse 1 ou plus de fois mais chaque occurrence doit être séparée d'une autre par une virgule. bold smaller#

Spécifications

Spécification État Comment
CSS Values and Units Module Level 3
La définition de 'Value definition syntax' dans cette spécification.
Candidat au statut de recommandation Ajout du multiplicateur avec le dièse.
CSS Level 2 (Revision 1)
La définition de 'Value definition syntax' dans cette spécification.
Recommendation Ajout de la double esperluette.
CSS Level 1
La définition de 'Value definition syntax' dans cette spécification.
Recommendation Définition initiale.

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : SphinxKnight, Sebastianz, Prinz_Rana, Guillaume-Heras, prayash, pixoux, teoli, FredB
 Dernière mise à jour par : SphinxKnight,