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

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

Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.

L'élément HTML <rb> est utilisé pour délimiter le composant de texte de base d'une annotation <ruby>, c'est-à-dire le texte annoté. Un élément <rb> doit entourer chaque segment atomique distinct du texte de base.

Attributs

Cet élément inclut uniquement les attributs universels.

Notes d'utilisation

  • Les annotations ruby sont utilisées afin d'afficher la prononciation pour les caractères d'Asie orientale, comme les furigana japonais ou les caractères bopomofo taïwanais. 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 d'inclure uniquement la balise d'ouverture de chaque élément dans le code source, afin de simplifier le balisage ruby et de le rendre plus lisible. Le navigateur complète alors l'élément lors de l'affichage.
  • Il faut inclure un élément <rt> pour chaque segment de base <rb> que l'on souhaite annoter.

Exemples

Utiliser rb

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>

Remarquez que nous avons inclus deux éléments <rb> pour délimiter les deux parties distinctes du texte de base ruby. L'annotation, quant à elle, est délimitée par deux éléments <rt>.

Résultat

Annotations séparées

Notez que l'on pourrait aussi écrire cet exemple avec les deux parties du texte de base annotées complètement séparément. Dans ce cas, il n'est pas 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

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.
Parents autorisés Un élément <ruby>.
Rôles ARIA autorisés Tous les rôles sont autorisés.
Interface DOM HTMLElement

Spécifications

Specification
HTML
# rb

Compatibilité des navigateurs

Voir aussi