La balise HTML <rp>
La balise <rp> définit un texte alternatif affiché dans les navigateurs ne prenant pas en charge la balise <ruby>.
La balise <rp> (parenthèse ruby) fournit des parenthèses de secours pour les navigateurs qui ne prennent pas en charge l'élément <ruby>. Les annotations ruby sont de petits textes affichés à côté d'un caractère de base pour indiquer sa prononciation ou sa signification — une convention très utilisée dans les publications est-asiatiques (japonaises, chinoises).
La balise <rp> fait partie des éléments HTML5.
Comment <ruby>, <rt> et <rp> fonctionnent ensemble
Une annotation ruby est construite à partir de trois éléments qui jouent des rôles distincts :
<ruby>— le conteneur qui enveloppe le texte de base et son annotation.<rt>(texte ruby) — l'annotation proprement dite, la prononciation ou la note affichée au-dessus (ou à côté) du caractère de base.<rp>(parenthèse ruby) — les caractères de secours, généralement(et), qui encadrent l'annotation uniquement lorsque ruby n'est pas pris en charge.
L'idée clé réside dans le rendu conditionnel :
- Les navigateurs qui prennent en charge ruby masquent le contenu de chaque élément
<rp>et affichent l'annotation<rt>à sa position correcte (au-dessus du texte de base). Le lecteur ne voit jamais les parenthèses. - Les navigateurs qui ne prennent pas en charge ruby ignorent le positionnement et affichent tout en ligne. Les parenthèses
<rp>deviennent alors visibles, de sorte que漢字(Kanji)reste lisible sous forme de texte brut au lieu d'un漢字Kanjiambigu.
On place un <rp> avant le <rt> (la parenthèse ouvrante) et un après (la parenthèse fermante) afin que l'annotation soit encadrée des deux côtés en mode de secours.
Syntaxe
L'élément <rp> s'écrit avec une balise ouvrante et une balise fermante. Selon HTML5, la balise fermante (</rp>) est facultative : elle peut être omise si l'élément <rp> est immédiatement suivi d'un autre élément <rp> ou <rt>, ou s'il n'y a plus de contenu dans l'élément parent <ruby>. L'inclure est toujours sûr et est recommandé pour la clarté.
Exemple de la balise HTML <rp> :
Balise HTML <rp>
<!DOCTYPE html>
<html>
<head>
<title>Title of the document</title>
</head>
<body>
<ruby>
漢 <rp>(</rp><rt>Kan</rt><rp>)</rp>
字 <rp>(</rp><rt>ji</rt><rp>)</rp>
</ruby>
</body>
</html>Résultat
Dans un navigateur prenant en charge ruby, la sortie affiche « Kan ji » au-dessus de « 漢字 » et les parenthèses restent masquées. Dans un navigateur sans prise en charge de ruby, le même balisage se dégrade en texte inline 漢(Kan)字(ji) — les parenthèses <rp> maintiennent l'annotation lisible.
Attributs
La balise <rp> prend en charge les Attributs globaux et les Attributs d'événement.
Balises associées
<ruby>— le conteneur d'une annotation ruby.<rt>— le texte de l'annotation ruby (prononciation ou note).<rb>— marque le texte de base d'une annotation ruby.