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

<ruby> : l'élément d'annotation de Ruby

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'élément HTML <ruby> représente de petites annotations affichées au-dessus, en dessous ou à côté du texte de base, généralement utilisées pour indiquer la prononciation des caractères d'Asie orientale. Il peut aussi servir à annoter d'autres types de texte, mais cet usage est moins courant.

Le terme ruby vient d'une unité de mesure utilisée par les typographes (angl.), représentant la plus petite taille à laquelle un texte peut être imprimé sur du papier journal tout en restant lisible.

Exemple interactif

<ruby> 明日 <rp>(</rp><rt>Ashita</rt><rp>)</rp> </ruby>
ruby {
  font-size: 2em;
}

Attributs

Cet élément inclut uniquement les attributs universels.

Exemples

Exemple 1 : Caractère

html
<ruby>
  漢 <rp>(</rp><rt>Kan</rt><rp>)</rp> 字 <rp>(</rp><rt>ji</rt><rp>)</rp>
</ruby>

Résultat

Exemple 2 : Mot

html
<ruby> 明日 <rp>(</rp><rt>Ashita</rt><rp>)</rp> </ruby>

Résultat

Résumé technique

Catégories de contenu Contenu de flux, contenu de phrasé, contenu tangible.
Contenu autorisé Contenu de phrasé.
Omission de balises Aucune, la balise d'ouverture et la balise de fermeture sont obligatoires.
Parents autorisés Tout élément qui accepte du contenu de phrasé.
Rôle ARIA implicite Pas de rôle correspondant (angl.)
Rôles ARIA autorisés Tous les rôles sont autorisés.
Interface DOM HTMLElement

Spécifications

Specification
HTML
# the-ruby-element

Compatibilité des navigateurs

Voir aussi