W3docs

Tag HTML <rp>

A tag <rp> define um texto alternativo exibido em navegadores que não suportam a tag <ruby>.

A tag <rp> (parênteses ruby) fornece parênteses alternativos para navegadores que não suportam o elemento <ruby>. As anotações ruby são pequenos textos exibidos ao lado de um caractere base para indicar sua pronúncia ou significado — uma convenção muito utilizada em publicações do Leste Asiático (japonês, chinês).

A tag <rp> é um dos elementos HTML5.

Como <ruby>, <rt> e <rp> funcionam juntos

Uma anotação ruby é construída com três elementos que desempenham papéis distintos:

  • <ruby> — o contêiner que envolve o texto base e sua anotação.
  • <rt> (texto ruby) — a anotação propriamente dita, a pronúncia ou nota renderizada acima (ou ao lado) do caractere base.
  • <rp> (parênteses ruby) — os caracteres alternativos, geralmente ( e ), que envolvem a anotação somente quando ruby não é suportado.

A ideia central é a renderização dividida:

  • Navegadores que suportam ruby ocultam o conteúdo de cada elemento <rp> e exibem a anotação <rt> em sua posição correta (acima do texto base). O leitor nunca vê os parênteses.
  • Navegadores que não suportam ruby ignoram o posicionamento e renderizam tudo de forma inline. Os parênteses de <rp> ficam visíveis, de modo que 漢字(Kanji) é lido de forma compreensível como texto simples, em vez do ambíguo 漢字Kanji.

Coloca-se um <rp> antes do <rt> (o parêntese de abertura) e outro depois dele (o parêntese de fechamento), de modo que a anotação fique envolvida em ambos os lados no caso alternativo.

Sintaxe

O elemento <rp> é escrito com uma tag de abertura e uma tag de fechamento. De acordo com o HTML5, a tag de fechamento (</rp>) é opcional: ela pode ser omitida se o elemento <rp> for imediatamente seguido por outro elemento <rp> ou <rt>, ou se não houver mais conteúdo no elemento pai <ruby>. Incluí-la é sempre seguro e recomendado para maior clareza.

Exemplo da 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>

Resultado

exemplo da tag rp

Em um navegador com suporte a ruby, a saída exibe "Kan ji" acima de "漢字" e os parênteses permanecem ocultos. Em um navegador sem suporte a ruby, a mesma marcação se degrada ao texto inline 漢(Kan)字(ji) — os parênteses de <rp> mantêm a anotação legível.

Atributos

A tag <rp> suporta os Atributos Globais e os Atributos de Evento.

Tags relacionadas

  • <ruby> — o contêiner de uma anotação ruby.
  • <rt> — o texto da anotação ruby (pronúncia ou nota).
  • <rb> — marca o texto base de uma anotação ruby.

Prática

Prática
Para que serve a tag HTML <rp> na codificação HTML?
Para que serve a tag HTML <rp> na codificação HTML?
Was this page helpful?