Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Attribut HTML universel : title

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.

L'attribut universel title contient un texte d'information relatif à l'élément auquel il est rattaché.

Exemple interactif

<p>
  Utilisez l'attribut <code>title</code> sur un <code>iframe</code> pour
  identifier clairement le contenu de l'<code>iframe</code> aux lecteurs
  d'écran.
</p>

<iframe
  title="Page Wikipédia pour le langage HTML"
  src="https://fr.m.wikipedia.org/wiki/HTML"></iframe>
<iframe
  title="Page Wikipédia pour le langage CSS"
  src="https://fr.m.wikipedia.org/wiki/CSS"></iframe>
iframe {
  height: 200px;
  margin-bottom: 24px;
  width: 100%;
}

L'usage principal de l'attribut title est d'étiqueter les éléments <iframe> pour les technologies d'assistance.

L'attribut title peut aussi être utilisé pour étiqueter les contrôles dans les tables de données.

L'attribut title, lorsqu'il est ajouté à <link rel="stylesheet">, crée une feuille de style alternative. Lors de la définition d'une feuille de style alternative avec <link rel="alternate">, l'attribut est requis et doit être défini sur une chaîne de caractères qui n'est pas vide.

S'il est inclus sur la balise d'ouverture <abbr>, le title doit être une expansion complète de l'abréviation ou de l'acronyme. Au lieu d'utiliser title, lorsque c'est possible, fournir l'expansion de l'abréviation ou de l'acronyme en texte clair lors de la première utilisation, en utilisant <abbr> pour baliser l'abréviation. Cela permet à tous les utilisateur·ice·s de savoir quel nom ou terme l'abréviation ou l'acronyme raccourcit tout en fournissant un indice aux agents utilisateur sur la façon d'annoncer le contenu.

Bien que title puisse être utilisé pour fournir un label associé de manière programmatique à un élément <input>, ce n'est pas une bonne pratique. Utiliser un <label> à la place.

Titre sur plusieurs lignes

Un attribut title peut contenir plusieurs lignes. Chaque caractère U+000A LINE FEED (LF) représentera un saut de ligne. Le fragment de code suivant représente donc un élément dont le titre est écrit sur deux lignes :

HTML

html
<p>
  Les sauts de ligne au sein d'un attribut <code>title</code> doivent être pris
  en compte. Cet
  <span
    title="Ceci est un
titre sur plusieurs lignes">
    exemple de span
  </span>
  a un attribut title avec un saut de ligne.
</p>
<hr />
<pre id="output"></pre>

JavaScript

Nous pouvons interroger l'attribut title et l'afficher dans l'élément <pre> vide comme suit :

js
const span = document.querySelector("span");
const output = document.querySelector("#output");
output.textContent = span.title;

Résultat

Héritage de l'attribut title

Si un élément ne possède pas d'attribut title, il l'hérite de son nœud parent, qui peut à son tour l'hériter de son parent, et ainsi de suite.

Si cet attribut est défini sur la chaîne vide, cela signifie que les title de ses ancêtres sont sans objet et ne doivent pas être utilisés dans la bulle d'information de cet élément.

HTML

html
<div title="Une bubulle">
  <p>
    Si vous survolez cet élément, il y aura une bulle d'information "Une
    bubulle".
  </p>
  <p title="">Et au-dessus de celui-ci, aucune info.</p>
</div>

Résultat

Problèmes d'accessibilité

L'attribut title est très problématique pour :

  • Les personnes qui utilisent des appareils à interface tactile
  • Les personnes qui naviguent au clavier
  • Les personnes qui naviguent en utilisant des outils d'assistance comme des lecteurs d'écran ou des loupes logicielles
  • Les personnes souffrant de troubles cognitifs

Ceci est dû à une prise en charge hétérogène des navigateurs, aggravée par le traitement supplémentaire effectué par les technologies d'assistance sur la page rendue par le navigateur. Si un effet de bulle d'information est souhaité, il est préférable d'utiliser une technique plus accessible (angl.) pouvant être utilisée avec les méthodes de navigation ci-dessus.

Spécifications

Specification
HTML
# the-title-attribute

Compatibilité des navigateurs

Voir aussi