<rb> : l'élément de base ruby

L'élément de base ruby (<rb>) est utilisé afin de délimiter le composant texte de base d'une annotation <ruby>. Autrement dit, le texte qui est annoté. Un élément <rb> devrait encadrer chaque segment atomique du texte de base.

Attributs

Seuls les attributs universels peuvent être utilisés sur cet élément.

Notes d'utilisation

  • Les annotations ruby sont utilisées afin d'afficher la prononciation pour les caractères d'Asie orientale tels que les caractères japonais furigana ou les caractères taïwanais bopomofo. L'élément <rb> permet de séparer chaque segment du texte de base ruby.
  • Bien que <rb> ne soit pas un élément vide, il est courant de n'inclure que la balise d'ouverture de chaque élément afin de simplifier le balisage dédié aux annotations ruby.
  • Il faut inclure un élément <rt> pour chaque segment de base <rb> qu'on souhaite annoter.

Exemples

Dans cet exemple, on fournit une annotation pour le caractère original correspondant à "Kanji" :

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

Résultat

On voit ici que deux éléments <rb> sont inclus et permettent de délimiter les deux segments du texte de base. Pour l'annotation, chaque partie correspondante est délimitée par un élément <rt>.

On aurait également pu écrire cet exemple avec les deux parties du texte de base complètement séparées. Dans ce cas, il n'aurait pas été nécessaire d'inclure les éléments <rb> :

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

Résultat

Avec prise en charge de ruby

Résultat

Pour un navigateur qui ne prend pas en charge les annotations ruby, voici à quoi aurait ressemblé le résultat :

Sans prise en charge de ruby

Résultat

Note : Voir l'article sur l'élément <ruby> pour de plus amples exemples.

Résumé technique

Catégories de contenu Aucune.
Contenu autorisé Cet élément peut être l'élément fils d'un élément <ruby>.
Omission de balise La balise de fin peut être omise si l'élément est immédiatement suivi d'un élément <rt>, <rtc> ou <rp> ou encore par un autre élément <rb> ou s'il n'y a plus de contenu dans l'élément parent.
Éléments parents autorisés Un élément <ruby>.
Rôles ARIA autorisés N'importe quel rôle
Interface DOM HTMLElement

Spécifications

Specification
HTML Standard
# rb

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi