Sur la page d'un tutoriel, vous écrivez une formule comme "aire = π × rayon²", ou un extrait de code comme total = prix * quantite. Dans les deux cas, certains mots ne sont pas du texte ordinaire : ce sont des emplacements qui représentent une valeur qui change, un rayon, un prix, une quantité. Rien dans un simple paragraphe ne distingue ces mots-là du reste de la phrase.
La balise <var> comble ce manque : elle marque explicitement un mot ou une courte expression comme étant une variable, que ce soit dans une expression mathématique ou dans un extrait de code informatique. Par défaut, les navigateurs l'affichent en italique, mais ce style n'est qu'une convention, pas l'essentiel de la balise.
Définition
<var> est une balise sémantique de bas niveau qui désigne le nom d'une variable dans une expression mathématique, un identifiant dans un extrait de programme, ou plus généralement un espace réservé destiné à être remplacé par une valeur réelle. Elle ne calcule rien et ne déclare aucune variable : elle décrit simplement, pour qui lit la page ou pour un outil qui l'analyse, la nature de ce mot précis.
On la trouve aussi bien seule, glissée dans une phrase ordinaire, qu'à l'intérieur d'un bloc <code>, pour distinguer la partie qui change, le nom du fichier ou l'identifiant à remplacer, de la syntaxe fixe qui l'entoure.
Contextes d'usage : maths et code
Dans une formule, <var> entoure chaque lettre qui représente une grandeur. Écrire que l'aire d'un cercle vaut π multiplié par <var>rayon</var> au carré indique que "rayon" n'est pas un mot du langage courant, mais une inconnue de la formule.
Dans un extrait de code ou une consigne technique, elle marque plutôt un espace réservé que le lecteur doit remplacer par sa propre valeur : "Remplacez <var>nomDeFichier</var> par le nom réel de votre fichier". Cette distinction entre ce qu'il faut recopier tel quel et ce qu'il faut adapter est justement ce que la balise permet d'exprimer.
Exemple concret
Voici une instruction technique qui combine <code> pour la syntaxe fixe et <var> pour la partie que le lecteur doit personnaliser.
<p>
Exécutez <code>git clone <var>url-du-depot</var></code> dans votre terminal.
</p>Un lecteur comprend immédiatement que "git clone" s'écrit mot pour mot, tandis que "url-du-depot" est un texte à remplacer par la véritable adresse du dépôt.
Ne pas confondre avec le mot-clé var de JavaScript
Le nom est identique, mais les deux n'ont rien en commun. Le mot-clé var en JavaScript déclare une véritable variable dans un programme, avec une valeur qui peut être lue, modifiée, utilisée dans des calculs. La balise <var> en HTML, elle, n'existe que dans le texte de la page : elle ne stocke rien, n'exécute rien, et n'a aucune existence du côté du programme qui tournerait sur cette page.
Écrire <var>total</var> dans une page HTML ne crée aucune variable nommée total accessible en JavaScript, et déclarer var total dans un script ne produit aucun texte en italique sur la page. La confusion vient uniquement du nom partagé, hérité du même mot anglais "variable" utilisé dans deux contextes complètement différents : l'un décrit du texte, l'autre exécute du code.
Différence avec les balises voisines
<var> appartient à une petite famille de balises qui décrivent chacune un aspect différent du texte lié au code informatique.
| Balise | Ce qu'elle représente | Exemple typique |
|---|---|---|
<code> | Un extrait de code, tel qu'il doit être écrit | fetch(url) |
<var> | Une variable ou un espace réservé à remplacer | url dans fetch(url) |
<samp> | Une sortie affichée par un programme | Fichier introuvable |
Ces trois balises se combinent souvent dans une même explication technique : le code fixe dans <code>, la partie variable dans <var>, et le résultat obtenu dans <samp>.
Questions fréquentes
var crée-t-elle une vraie variable, comme en JavaScript ?Non. Elle décrit seulement du texte : elle indique qu'un mot représente une variable, sans stocker aucune valeur ni exécuter aucun calcul. Le navigateur l'affiche simplement en italique par défaut, exactement comme il le ferait pour n'importe quel autre texte mis en forme, sans lien avec le fonctionnement d'un programme JavaScript.
var autrement qu'en italique ?Oui, l'italique n'est qu'une suggestion de style par défaut, modifiable avec du CSS comme n'importe quel autre élément, par exemple avec font-style: normal associé à une couleur ou une graisse différente. Changer l'apparence ne change rien au sens de la balise, qui reste porté par le HTML, pas par le style visuel.
var pour un nom de variable dans un titre de tutoriel, comme "Remplacez API_KEY par votre clé" ?Oui, c'est exactement l'usage prévu. Entourer "API_KEY" de <var> signale clairement au lecteur que ce mot est un espace réservé à remplacer par sa propre valeur, et non une instruction à recopier telle quelle, ce qui évite une confusion fréquente dans les tutoriels techniques.