Tag HTML <rb> | W3Docs

L'elemento HTML <rb> veniva utilizzato per delimitare il componente di testo base di un'annotazione <ruby> — i caratteri a cui è associata una guida alla pronuncia.

Attenzione

Deprecato — non usare <rb> nel nuovo codice. L'elemento <rb> è stato rimosso dallo standard HTML, e il supporto dei browser è inaffidabile. Non è necessario: nell'HTML moderno il testo base è inserito direttamente all'interno di <ruby>, senza alcun elemento contenitore. Questa pagina è mantenuta solo per aiutarti a riconoscere e migrare il markup legacy.

Cosa sono le annotazioni ruby

Un'annotazione ruby è un breve testo presentato accanto a un testo base, tipicamente utilizzato nella tipografia est-asiatica per indicare la pronuncia (lettura) dei caratteri. L'annotazione viene resa con un carattere più piccolo, solitamente sopra o a lato dei caratteri base.

Un'annotazione ruby è composta da tre elementi moderni:

<ruby> — il contenitore per l'intera annotazione.
<rt> — il ruby text: la pronuncia/annotazione vera e propria.
<rp> — le parentesi ruby opzionali, mostrate solo dai browser che non supportano il ruby, in modo che il testo degradi a qualcosa come 漢字 (kanji).

Nel markup precedente, <rb> (e il parimenti deprecato <rtc>) racchiudeva il testo base. Oggi il testo base non ha bisogno di alcun elemento contenitore.

Il pattern moderno (da usare)

Inserisci il testo base direttamente all'interno di <ruby>, poi segui ogni segmento base con il suo <rt>. Racchiudi il contenuto di <rt> tra parentesi <rp> affinché l'annotazione risulti leggibile anche dove il ruby non è supportato.

Esempio di annotazione ruby moderna (senza `<rb>`):

<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      body {
        font-size: 30px;
      }
    </style>
  </head>
  <body>
    <ruby>
      漢 <rp>(</rp><rt>kan</rt><rp>)</rp>
      字 <rp>(</rp><rt>ji</rt><rp>)</rp>
    </ruby>
  </body>
</html>

Provalo tu stesso »

Risultato

Un browser che supporta il ruby renderizza kan sopra 漢 e ji sopra 字. Un browser che non lo supporta ricade su 漢 (kan) 字 (ji), grazie agli elementi <rp>.

Markup `<rb>` legacy (riconosci, non usare)

Potresti ancora incontrare documenti più vecchi che racchiudono ogni segmento base in <rb>. L'esempio sottostante è mostrato solo per aiutarti a riconoscerlo — sostituiscilo con il pattern moderno illustrato sopra.

<!-- Legacy markup — DO NOT USE in new code -->
<ruby>
  <rb>漢</rb>
  <rb>字</rb>
  <rp>(</rp><rt>kan</rt><rt>ji</rt><rp>)</rp>
</ruby>

Per migrare, rimuovi i tag <rb> e lascia i caratteri base direttamente all'interno di <ruby>.

Supporto dei browser

<rb> non fa parte dell'attuale specifica HTML. Anche dove i browser lo tollerano, il comportamento è inconsistente, quindi non dovresti farci affidamento. La combinazione moderna <ruby> / <rt> / <rp> è ben supportata nei browser attuali.

Tag correlati

<ruby> — il contenitore dell'annotazione ruby.
<rt> — il testo dell'annotazione ruby.
<rp> — parentesi di fallback per i browser che non supportano il ruby.

Esercitati

Pratica

Quali affermazioni sul tag deprecato <rb> e sulle annotazioni ruby moderne sono corrette?

Il tag <rb> viene usato per specificare una colonna in una tabella.L'elemento <rb> veniva usato per delimitare il testo base di un'annotazione ruby, ma è ora deprecato e rimosso dallo standard HTML.Nell'HTML moderno, il testo base è inserito direttamente all'interno di <ruby> senza elementi contenitore.Il tag <rb> deve essere usato insieme ai tag <rtc> e <rt>.Dovresti usare <rb> nel nuovo codice per il miglior supporto browser.