L'élément <abbr>
représente une abréviation ou un acronyme et permet, de façon optionnelle, d'en fournir une description complète. S'il est présent, l'attribut {{htmlattrxref("title")}} doit contenir cette même description complète et rien d'autre.
Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner https://github.com/mdn/interactive-examples et à envoyer une pull request !
Note : Voir cet article introductif pour la mise en forme du texte en général.
Cet élément n'a pas d'autres attributs que les attributs universels.
On notera que l'attribut {{htmlattrdef("title")}} possède ici une sémantique spécifique et il représente la description complète de l'abréviation. Souvent, mais pas nécessairement, il s'affiche comme une info-bulle au survol de la souris.
Chaque élément <abbr>
est indépendant, rattacher un titre à l'un ne l'associe pas aux abrévations identiques qui suivent.
Il n'est pas obligatoire d'utiliser <abbr>
pour toutes les abrévations d'un document mais voici quelques cas où cet élément s'avère pertinent :
<abbr>
avec un attribut {{htmlattrxref("title")}} adéquat.<abbr>
avec un attribut title
explicatif pourra être utilisé.<abbr>
pour identifier ces contenus.<abbr>
et de {{HTMLElement("dfn")}}. Voir ci-après pour un exemple.Lorsqu'il est présent, le nombre (grammatical) du texte de l'attribut title
devrait correspondre à celui du contenu de l'élément abbr
. C'est également le cas dans les langues avec plus de deux genres grammaticaux (par exemple, l'Arabe, en plus des catégories pour le singulier et le pluriel, possède également une catégorie double).
Le but de cet élément est purement explicatif. Tous les navigateurs l'affichent en ligne ({{cssxref('display')}}: inline
) par défaut mais le reste de la mise en forme par défaut peut varier d'un navigateur à l'autre :
: none
.On peut baliser une abrévation sans fournir de description ou de définition, il suffit d'utiliser <abbr>
sans attribut.
<p>Nous allons voir le <abbr>HTML</abbr> qui sert à construire des pages web.</p>
{{EmbedLiveSample("Baliser_une_abréviation_pour_marquer_la_sémantique")}}
CSS peut être utilisé pour appliquer une mise en forme particulière sur les abréviations.
<p>Avec <abbr>CSS</abbr>, on peut mettre en forme les éléments.</p>
abbr { font-variant: all-small-caps; }
{{EmbedLiveSample("Mettre_en_forme_des_abréviations")}}
On peut ajouter un attribut {{htmlattrxref("title")}} afin de fournir une description de l'abréviation ou de l'acronyme.
<p>Et là je lui ai répondu <abbr title="Laugh Out Loud">LOL</abbr>.</p>
{{EmbedLiveSample("Fournir_une_description")}}
Il est possible d'utiliser l'élément <abbr>
avec {{HTMLElement("dfn")}} afin de formellement définir une abréviation.
<p><dfn id="html"><abbr title="HyperText Markup Language">HTML</abbr> </dfn> est un langage de balise qui permet de créer la structure et d'organiser la sémantique d'une page web.</p> <p>Une <dfn id="spec">Spécification</dfn> (<abbr title="Specification">spec</abbr>) est un document qui décrit, de façon détaillée comme une technologie ou une API fonctionne et comment l'utiliser.</p>
{{EmbedLiveSample("Définir_une_abréviation", 600, 120)}}
C'est une bonne pratique que d'épeler l'acronyme ou l'abréviation lorsqu'elle est utilisée pour la première fois. Cela permet au lecteur de mieux comprendre le terme, notamment si celui-ci est technique ou appartient à un jargon spécifique.
<p>JavaScript Object Notation (<abbr>JSON</abbr>) est un format léger d'échange de données.</p>
Cela peut servir aux personnes qui découvrent ces concepts pour la première fois ou pour les personnes souffrant de troubles cognitifs.
Catégories de contenu | Contenu de flux, contenu phrasé, contenu tangible. |
---|---|
Contenu autorisé | Contenu phrasé. |
Omission de balises | {{no_tag_omission}} |
Parents autorisés | Tout élément acceptant du contenu phrasé. |
Rôles ARIA autorisés | Tous les rôles sont autorisés. |
Interface DOM | {{domxref("HTMLElement")}} |
Specification | Status | Comment |
---|---|---|
{{SpecName('HTML WHATWG', 'semantics.html#the-abbr-element', '<abbr>')}} | {{Spec2('HTML WHATWG')}} | |
{{SpecName('HTML5 W3C', 'text-level-semantics.html#the-abbr-element', '<abbr>')}} | {{Spec2('HTML5 W3C')}} | |
{{SpecName('HTML4.01', 'struct/text.html#edef-ABBR', '<abbr>')}} | {{Spec2('HTML4.01')}} |
{{Compat("html.elements.abbr")}}
<abbr>
<abbr>