<caption>
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
O elemento HTML caption
especifica a legenda (ou título) de uma tabela.
Experimente
Categoria de conteúdo | Nenhuma. |
---|---|
Conteúdo permitido | Flow content. |
Omissão de tag | A tag final pode ser omitida se o elemento não for seguido imediatamente por um espaço em branco ASCII ou um comentário. |
Elementos pais permitidos | Um elemento <table> , como seu primeiro filho. |
Função ARIA implícita | Nenhuma função correspondente |
Permitted ARIA roles | No role permitted |
DOM interface | HTMLTableCaptionElement |
Atributos
Este elemento inclui os atributos globais.
Atributos obsoletos
Os seguintes atributos são obsoletos e não devem ser usados. Estão documentados abaixo apenas como referência ao atualizar o código, e interesse histórico.
align
Deprecated-
Esse atributo enumerado indica como a legenda deve ser alinhada em relação à tabela. Ele pode ter um dos seguintes valores:
left
-
A legenda é exibida à esquerda da tabela.
top
-
A legenda é exibida acima da tabela.
right
-
A legenda é exibida à direita da tabela.
bottom
-
A legenda é exibida abaixo da tabela.
Aviso: Não use este atributo já que ele foi depreciado: O elemento
<caption>
deve ser estilizado usando as propriedades CSS. Para dar um efeito similar ao atributoalign
, use as propriedades CSScaption-side
etext-align
.
Notas de uso
Se utilizado, o elemento <caption>
deve ser o primeiro filho de seu elemento <table>
pai.
Quando o elemento <table>
que contém o <caption>
é o único descendente de um elemento <figure>
, você deve usar o <figcaption>
elemento em vez de <caption>
.
Um background-color
na tabela não incluirá a legenda. Adicione um background-color
ao elemento <caption>
também se você deseja que a mesma cor de fundo esteja por trás de ambos.
Exemplo
Esse exemplo simples apresenta uma tabela que inclui uma legenda
<table>
<caption>
Exemplo de Legenda
</caption>
<tr>
<th>Login</th>
<th>Email</th>
</tr>
<tr>
<td>usuario1</td>
<td>usuario1@dominio.com</td>
</tr>
<tr>
<td>usuario2</td>
<td>usuario2@dominio.com</td>
</tr>
</table>
Especificações
Specification |
---|
HTML Standard # the-caption-element |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também
-
Propriedades CSS que podem ser especialmente úteis para estilizar o elemento
<caption>
: