Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

dfn — occurrence définissant un terme

L’élément dfn marque l’occurrence où un terme est défini. Il entoure le terme, et non toute l’explication ; un lien peut le cibler au moyen de id.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<dfn id="term">term</dfn>

dfn marque l’occurrence où un terme est défini. Son ancêtre le plus proche qui est un paragraphe, un groupe de liste de descriptions ou une section doit contenir sa définition. Marquez le terme, et non toute l’explication.

Si dfn possède un attribut title, sa valeur donne le terme. Sinon, on utilise la valeur de title d’un abbr uniquement si cet élément est le seul enfant de dfn qui soit un élément, s’il possède lui-même un attribut title et si dfn n’a aucun nœud texte comme enfant direct. Dans tous les autres cas, le terme est le texte des descendants de dfn. Un title sur dfn doit contenir uniquement le terme, pas sa définition. Le title d’un ancêtre n’influe pas sur ce choix.

L’élément accepte les attributs globaux et le contenu de phrasé, mais ne peut pas contenir de dfn descendant. Les deux balises sont obligatoires. Un lien a ciblant un dfn représente une utilisation du terme défini.

Dans l’exemple, le premier paragraphe fournit la définition, et id="token" permet d’y faire référence au moyen de href="#token". Le résultat attendu décrit le texte, pas la typographie.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Defining a term</title>
<p>A <dfn id="token">token</dfn> is a named unit in this example.</p>
<p>See the definition of <a href="#token">token</a>.</p>
</html>

Résultat

A token is a named unit in this example.

See the definition of token.

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources