Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
<rb> : l'élément de base ruby
L'élément debase 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.
Dans cet article
Attributs
Seuls lesattributs 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" :
<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> :
<ruby> 漢 <rp>(</rp><rt>Kan</rt><rp>)</rp> 字 <rp>(</rp><rt>ji</rt><rp>)</rp></ruby>Résultat
Avec prise en charge de ruby
<ruby> <rb>漢</rb><rb>字 </rb><rp>(</rp><rt>kan</rt><rt>ji</rt><rp>)</rp></ruby>body { font-size: 22px;}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
漢字 (kan ji)body { font-size: 22px;}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> # rb> |