W3docs

Tag HTML <rb>

Use a tag HTML <rb> para delimitar o texto base de anotações <ruby>, usadas na tipografia do Leste Asiático. Veja exemplos práticos.

O elemento HTML <rb> era usado para delimitar o componente de texto base de uma anotação <ruby> — os caracteres aos quais um guia de pronúncia é associado.

Aviso

Descontinuado — não use <rb> em código novo. O elemento <rb> foi removido do padrão HTML, e o suporte dos navegadores é irregular. Não há necessidade dele: no HTML moderno, o texto base é colocado diretamente dentro de <ruby>, sem nenhum elemento de contêiner. Esta página existe apenas para ajudá-lo a reconhecer e migrar marcações legadas.

O que são anotações ruby

Uma anotação ruby é um trecho curto de texto apresentado ao lado de um texto base, normalmente utilizado na tipografia do Leste Asiático para indicar a pronúncia (leitura) de caracteres. A anotação é renderizada em uma fonte menor, geralmente acima ou ao lado dos caracteres base.

Uma anotação ruby é construída com três elementos modernos:

  • <ruby> — o contêiner para toda a anotação.
  • <rt> — o texto ruby: a pronúncia/anotação em si.
  • <rp>parênteses ruby opcionais, exibidos apenas por navegadores que não conseguem renderizar ruby, para que o texto seja degradado para algo como 漢字 (kanji).

Em marcações antigas, <rb> (e o também descontinuado <rtc>) envolvia o texto base. Hoje o texto base não precisa de nenhum contêiner.

O padrão moderno (use este)

Coloque o texto base diretamente dentro de <ruby>, seguido de cada segmento base com seu respectivo <rt>. Envolva o conteúdo de <rt> com parênteses <rp> para que a anotação ainda seja legível onde ruby não é suportado.

Exemplo de anotação ruby moderna (sem <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>

Resultado

Exemplo de anotação ruby em HTML

Um navegador que suporta ruby renderiza kan acima de e ji acima de . Um navegador que não suporta recorre a 漢 (kan) 字 (ji), graças aos elementos <rp>.

Marcação legada com <rb> (reconheça, mas não use)

Você ainda pode encontrar documentos antigos que envolvem cada segmento base em <rb>. O exemplo abaixo é mostrado apenas para que você possa reconhecê-lo — substitua-o pelo padrão moderno acima.

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

Para migrar, remova as tags <rb> e deixe os caracteres base diretamente dentro de <ruby>.

Suporte dos navegadores

<rb> não faz parte da especificação HTML atual. Mesmo onde os navegadores o toleram, o comportamento é inconsistente, portanto você não deve depender dele. A combinação moderna <ruby> / <rt> / <rp> é bem suportada nos navegadores atuais.

Tags relacionadas

  • <ruby> — o contêiner da anotação ruby.
  • <rt> — o texto (anotação) ruby.
  • <rp> — parênteses de fallback para navegadores sem suporte.

Prática

Prática
Quais afirmações sobre a tag <rb> descontinuada e as anotações ruby modernas estão corretas?
Quais afirmações sobre a tag <rb> descontinuada e as anotações ruby modernas estão corretas?
Was this page helpful?