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

<var> : l'élément de variable

Baseline Widely available

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

L'élément HTML <var> représente une variable dans une expression mathématique ou un texte lié à la programmation. Son contenu est généralement représenté avec une version italique de la police environnante utilisée, toutefois, ce comportement peut dépendre du navigateur utilisé.

Exemple interactif

<p>
  Le volume d'une boîte est <var>l</var> × <var>w</var> × <var>h</var>, où
  <var>l</var> représente la longueur, <var>w</var> la largeur et
  <var>h</var> la hauteur de la boîte.
</p>
var {
  font-weight: bold;
}

Attributs

Cet élément inclut uniquement les attributs universels.

Notes d'utilisation

Éléments associés

Voici d'autres éléments qui sont fréquemment utilisés dans les contextes où <var> est utilisé :

  • <code> : l'élément de code
  • <kbd> : l'élément de saisie au clavier
  • <samp> : l'élément de sortie d'exemple

Si vous trouvez du code qui utilise <var> par erreur à des fins de mise en forme plutôt que pour des raisons sémantiques, vous devriez utiliser un <span> avec la CSS appropriée ou un élément sémantique approprié parmi les suivants :

Mise en forme par défaut

La plupart des navigateurs appliquent la propriété font-style avec la valeur "italic" lors de l'affichage d'un élément <var>. Ce comportement peut être surchargé par la feuille de style CSS du site :

css
var {
  font-style: normal;
}

Exemples

Exemple simple

Voici un exemple simple, utilisant <var> pour indiquer des noms de variables dans une équation mathématique.

html
<p>Une équation simple&nbsp;: <var>x</var> = <var>y</var> + 2</p>

Résultat

Surcharger la mise en forme par défaut

À l'aide de CSS, vous pouvez surcharger le style par défaut de l'élément <var>. Dans cet exemple, les noms de variables sont affichés en gras, en utilisant Courier si disponible, sinon la police monospace par défaut est utilisée.

CSS

css
var {
  font:
    bold 15px "Courier",
    "Courier New",
    monospace;
}

HTML

html
<p>
  Les variables <var>minSpeed</var> et <var>maxSpeed</var> contrôlent les
  vitesses minimale et maximale de l'appareil et sont exprimées en tours par
  minute.
</p>

Cet exemple HTML utilise <var> pour entourer les noms de deux variables.

Résultat

Résumé technique

Catégories de contenu Contenu de flux, contenu phrasé, contenu tangible.
Contenu autorisé Contenu phrasé.
Omission de balises Aucune, la balise d'ouverture et la balise de fermeture sont obligatoires.
Parents autorisés Tout élément qui accepte du contenu phrasé.
Rôle ARIA implicite Pas de rôle correspondant (angl.)
Rôles ARIA autorisés Tous les rôles sont autorisés.
Interface DOM HTMLElement

Spécifications

Specification
HTML
# the-var-element

Compatibilité des navigateurs