<rp>

Des parenthèses de secours autour d’une annotation ruby, visibles seulement là où ruby n’est pas pris en charge.

Affichage
none
Balise fermante
Obligatoire
Contenu autorisé
Du texte, généralement une seule parenthèse
Sur cette page

Exemple

#
HTML
<p lang="zh" style="font-size: 2rem;">
  <ruby>中<rp>(</rp><rt>zhōng</rt><rp>)</rp>文<rp>(</rp><rt>wén</rt><rp>)</rp></ruby>
</p>
<p>Sans la prise en charge de ruby, cette notation apparaîtrait ainsi : 中(zhōng)文(wén)</p>
Aperçu

Définition et utilisation

#

L’élément <rp> (de l’anglais ruby parenthesis) contient une parenthèse ou un autre caractère qui entoure une annotation <rt>. Les navigateurs qui prennent en charge ruby le masquent, donc l’annotation apparaît au-dessus du texte, sans parenthèses.

Quand un programme ne comprend pas ruby, il affiche tout sur une seule ligne. Sans <rp>, le texte se fondrait en une suite illisible « 中zhōng文wén », tandis qu’avec les parenthèses, il apparaît ainsi : « 中(zhōng)文(wén) ».

Tous les navigateurs courants prennent aujourd’hui en charge ruby, donc <rp> est une protection pour les programmes qui affichent le HTML de façon simplifiée. Placez-le juste avant et juste après chaque <rt>.

Syntaxe

#
Syntaxe
<ruby>字<rp>(</rp><rt>zì</rt><rp>)</rp></ruby>

Attributs

#

Cet élément n’a pas d’attributs propres. Il accepte les attributs globaux, comme class, id ou hidden.

CSS par défaut

#

La plupart des navigateurs affichent cet élément avec ces styles par défaut :

CSS
rp {
  display: none;
}

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Ajoutez <rp> par paires : un ouvrant avant <rt>, un fermant après.
  • Au lieu de parenthèses rondes, vous pouvez utiliser d’autres caractères, par exemple des crochets.
  • <rp> n’a de sens qu’à l’intérieur de <ruby>.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.