<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

must be provided

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

must be provided

Avec prise en charge de ruby

Résultat

must be provided

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

must be provided

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
# rb

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
rb
Deprecated

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Deprecated. Not for use in new websites.

Voir aussi