---
title: ' : l''élément d''annotation non textuelle'
slug: Web/HTML/Element/u
tags:
- Element
- HTML
- Reference
- Web
translation_of: Web/HTML/Element/u
---
L'élément HTML <u>
permet d'afficher un fragment de texte qui est annoté avec des éléments non textuels. Par défaut, le contenu de l'élément est souligné. Cela pourra par exemple être le cas pour marquer un texte comme étant un nom propre chinois, ou pour marquer un texte qui a été mal orthographié.
Attention ! Cet élément était auparavant appelé underline pour les anciennes versions des spécifications HTML. Si on souhaite simplement souligner du texte, il ne faudra pas utiliser cet élément mais la propriété CSS {{cssxref("text-decoration")}} avec la valeur "underline"
.
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 !
Cet élément inclut uniquement les attributs universels.
Étant seulement un élément de mise en forme, l'élément {{HTMLElement("u")}} a été déprécié en HTML 4 et XHTML 1. Il a été ré-introduit en HTML5 avec une autre signification : le contenu de l'élément est annoté avec une annotation non-textuelle.
La spécification rappelle que dans la majorité des cas, d'autres éléments que <u>
doivent être utilisés.
Note : Attention à la mise en forme par défaut d'un élément <u>
qui le souligne. Cela peut être source de confusion entre un tel texte et un lien hypertexte (également souligné par défaut).
L'élément <u>
peut être utilisé afin d'indiquer des erreurs d'orthographe ou de grammaire, afin d'indiquer des noms propres au sein d'un texte écrit en chinois ou afin d'annoter un texte de façon visuelle.
L'élément <u>
ne doit pas être utilisé afin de simplement souligner un texte ou afin d'indiquer le titre d'une œuvre.
Dans la plupart des cas, il faudra utiliser un autre élément que <u>
:
Afin de fournir une annotation textuelle, on pourra utiliser l'élément {{HTMLElement("ruby")}}.
Afin de modifier la mise en forme, sans apporter de modification sémantique, on utilisera la propriété {{cssxref("text-decoration")}} avec la valeur "underline"
.
Dans cet exemple, on utilise <u>
et des règles CSS pour afficher un paragraphe qui contient une coquille. L'erreur est indiquée avec une ligne ondulée rouge sous le texte.
<p> Ce paragraphe contient un mot mal <u class="spelling">rothografié</u>. </p>
u.spelling { text-decoration: red wavy underline; }
{{EmbedLiveSample("Indiquer_une_erreur", 650, 80)}}
<u>
La plupart du temps, ce n'est pas l'élément <u>
qu'il faut utiliser. Voici quelques exemples de ces cas et les méthodes à privilégier.
Pour souligner du texte sans que cela ait une quelconque portée sémantique, on utilisera un élément {{HTMLElement("span")}} qu'on mettra en forme avec la propriété CSS {{cssxref("text-decoration")}} et la valeur "underline"
:
<span class="underline">Le plat du jour</span> <br> Soupe de potiron avec un soupçon de noix de muscade
.underline { text-decoration: underline; }
{{EmbedLiveSample("Souligner_pour_la_simple_mise_en_forme", 650, 80)}}
Les titres de livres doivent être indiqués avec un élément {{HTMLElement("cite")}} et non avec <u>
ou <i>
.
<p> Nous avons lu <cite>La Horde du Contrevent</cite> au cours du premier trimestre. </p>
{{EmbedLiveSample("example-unstyled-cite", 650, 80)}}
On notera que, par défaut, un élément <cite>
est affiché en italique. Ceci peut être modifié grâce à CSS :
cite { font-style: normal; text-decoration: underline; }
{{EmbedLiveSample("Indiquer_le_titre_pour_un_livre", 650, 80)}}
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 qui accepte du contenu phrasé. |
Rôles ARIA autorisés | Tous les rôles sont autorisés. |
Interface DOM | {{domxref("HTMLElement")}} |
Spécification | État | Commentaires |
---|---|---|
{{SpecName('HTML WHATWG', 'semantics.html#the-u-element', '<u>')}} | {{Spec2('HTML WHATWG')}} | |
{{SpecName('HTML5 W3C', 'text-level-semantics.html#the-u-element', '<u>')}} | {{Spec2('HTML5 W3C')}} | |
{{SpecName('HTML4.01', 'present/graphics.html#h-15.2.1', '<b>')}} | {{Spec2('HTML4.01')}} |
{{Compat("html.elements.u")}}
<u>
.<u>
.