Tag HTML <rp>
Il tag <rp> definisce un testo alternativo mostrato nei browser che non supportano il tag <ruby>.
Il tag <rp> (ruby parenthesis) fornisce parentesi di fallback per i browser che non supportano l'elemento <ruby>. Le annotazioni ruby sono piccoli testi visualizzati accanto a un carattere base per indicarne la pronuncia o il significato — una convenzione ampiamente utilizzata nelle pubblicazioni dell'Asia orientale (giapponese, cinese).
Il tag <rp> è uno degli elementi HTML5.
Come funzionano insieme <ruby>, <rt> e <rp>
Un'annotazione ruby è composta da tre elementi con ruoli distinti:
<ruby>— il contenitore che racchiude il testo base e la sua annotazione.<rt>(ruby text) — l'annotazione vera e propria, la pronuncia o la nota visualizzata sopra (o accanto) al carattere base.<rp>(ruby parenthesis) — i caratteri di fallback, solitamente(e), che racchiudono l'annotazione solo quando ruby non è supportato.
Il concetto chiave è il rendering differenziato:
- I browser che supportano ruby nascondono il contenuto di ogni elemento
<rp>e mostrano l'annotazione<rt>nella posizione corretta (sopra il testo base). Il lettore non vede mai le parentesi. - I browser che non supportano ruby ignorano il posizionamento e rendono tutto inline. Le parentesi
<rp>diventano quindi visibili, così漢字(Kanji)risulta leggibile come testo normale invece del poco chiaro漢字Kanji.
Si posiziona un <rp> prima dell'<rt> (la parentesi aperta) e uno dopo (la parentesi chiusa), in modo che l'annotazione sia racchiusa su entrambi i lati nel caso di fallback.
Sintassi
L'elemento <rp> è scritto con un tag di apertura e uno di chiusura. Secondo HTML5, il tag di chiusura (</rp>) è opzionale: può essere omesso se l'elemento <rp> è immediatamente seguito da un altro elemento <rp> o <rt>, oppure se non c'è altro contenuto nell'elemento <ruby> genitore. Includerlo è sempre sicuro ed è consigliato per chiarezza.
Esempio del tag HTML <rp>:
Tag 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>Risultato
In un browser con supporto ruby, l'output mostra "Kan ji" sopra "漢字" e le parentesi rimangono nascoste. In un browser senza supporto ruby, lo stesso markup degrada al testo inline 漢(Kan)字(ji) — le parentesi <rp> mantengono l'annotazione leggibile.
Attributi
Il tag <rp> supporta gli Attributi Globali e gli Attributi Evento.
Tag correlati
<ruby>— il contenitore per un'annotazione ruby.<rt>— il testo dell'annotazione ruby (pronuncia o nota).<rb>— indica il testo base di un'annotazione ruby.