From 8829a7c9eb82f180bac76ed5836aaef95be209a1 Mon Sep 17 00:00:00 2001 From: julieng Date: Wed, 13 Oct 2021 07:12:55 +0200 Subject: move *.html to *.md --- files/fr/web/html/element/abbr/index.md | 181 ++++++++++++++++++++++++++++++++ 1 file changed, 181 insertions(+) create mode 100644 files/fr/web/html/element/abbr/index.md (limited to 'files/fr/web/html/element/abbr/index.md') diff --git a/files/fr/web/html/element/abbr/index.md b/files/fr/web/html/element/abbr/index.md new file mode 100644 index 0000000000..178a8835df --- /dev/null +++ b/files/fr/web/html/element/abbr/index.md @@ -0,0 +1,181 @@ +--- +title: " : l'élément d'abréviation" +slug: Web/HTML/Element/abbr +tags: + - Acronym + - Definitions + - Element + - HTML + - HTML text-level semantics + - HTML:Flow content + - HTML:Palpable Content + - HTML:Phrasing content + - Reference + - Web + - abbr + - abbreviation + - semantics +translation_of: Web/HTML/Element/abbr +browser-compat: html.elements.abbr +--- +
{{HTMLRef}}
+ +

L'élément HTML <abbr> (abréviation en français) représente une abréviation ou un acronyme ; l'attribut facultatif title peut fournir une explication ou une description de l'abréviation. S'il est présent, title doit contenir cette description complète et rien d'autre.

+ +
{{EmbedInteractiveExample("pages/tabbed/abbr.html", "tabbed-shorter")}}
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Catégories de contenuContenu de flux, contenu phrasé, contenu tangible.
Contenu autoriséContenu phrasé.
Omission de balisesAucune, la balise d'ouverture et la balise de fermeture sont obligatoires.
Parents autorisésTout élément acceptant du contenu phrasé.
Rôles ARIA autorisésTous les rôles sont autorisés.
Interface DOMHTMLElement
+ +

Attributs

+ +

Cet élément n'a pas d'autres attributs que les attributs universels.

+ +

On notera que l'attribut 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éviations identiques qui suivent.

+ +

Notes d'utilisation

+ +

Cas d'usage généraux

+ +

Il n'est pas obligatoire d'utiliser <abbr> pour toutes les abréviations d'un document mais voici quelques cas où cet élément s'avère pertinent :

+ + + +

Grammaire

+ +

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

+ +

Mise en forme par défaut

+ +

Le but de cet élément est purement explicatif. Tous les navigateurs l'affichent en ligne (display: inline) par défaut mais le reste de la mise en forme par défaut peut varier d'un navigateur à l'autre :

+ + + +

Exemples

+ +

Baliser une abréviation pour marquer la sémantique

+ +

On peut baliser une abréviation sans fournir de description ou de définition, il suffit d'utiliser <abbr> sans attribut.

+ +

HTML

+ +
<p>
+  Nous allons voir le <abbr>HTML</abbr> qui sert à construire
+  des pages web.
+</p>
+ +

Résultat

+ +

{{EmbedLiveSample("marking_up_an_abbreviation_semantically", "100%", 80)}}

+ +

Mettre en forme des abréviations

+ +

CSS peut être utilisé pour appliquer une mise en forme particulière sur les abréviations.

+ +

HTML

+ +
<p>Avec <abbr>CSS</abbr>, on peut mettre en forme les éléments.</p>
+ +

CSS

+ +
abbr {
+  font-variant: all-small-caps;
+}
+ +

Résultat

+ +

{{EmbedLiveSample("styling_abbreviations", "100%", 80)}}

+ +

Fournir une description

+ +

On peut ajouter un attribut title afin de fournir une description de l'abréviation ou de l'acronyme.

+ +

HTML

+ +
<p>Et là je lui ai répondu <abbr title="Laugh Out Loud">LOL</abbr>.</p>
+ +

Résultat

+ +

{{EmbedLiveSample("providing_an_expansion", "100%", 80)}}

+ +

Définir une abréviation

+ +

Il est possible d'utiliser l'élément <abbr> avec <dfn> afin de formellement définir une abréviation.

+ +

HTML

+ +
<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="spécification">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>
+ +

Résultat

+ +

{{EmbedLiveSample("defining_an_abbreviation", "100%", 160)}}

+ +

Accessibilité

+ +

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.

+ +

Exemple

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

+ +

Spécifications

+ +

{{Specifications}}

+ +

Compatibilité des navigateurs

+ +

{{Compat}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf