Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
<th>
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
* Some parts of this feature may have varying levels of support.
Oelemento HTML<th> define uma célula cabeçalho do grupo de células de sua tabela. A exatidão natural deste grupo é definida pelos atributosscope eheaders.
In this article
Experimente
<table> <caption> Alien football stars </caption> <tr> <th scope="col">Player</th> <th scope="col">Gloobles</th> <th scope="col">Za'taak</th> </tr> <tr> <th scope="row">TR-7</th> <td>7</td> <td>4,569</td> </tr> <tr> <th scope="row">Khiresh Odo</th> <td>7</td> <td>7,223</td> </tr> <tr> <th scope="row">Mia Oolong</th> <td>9</td> <td>6,219</td> </tr></table>th,td { border: 1px solid rgb(160 160 160); padding: 8px 10px;}th[scope="col"] { background-color: #505050; color: #fff;}th[scope="row"] { background-color: #d6ecd4;}td { text-align: center;}tr:nth-of-type(even) { background-color: #eee;}table { border-collapse: collapse; border: 2px solid rgb(140 140 140); font-family: sans-serif; font-size: 0.8rem; letter-spacing: 1px;}caption { caption-side: bottom; padding: 10px;}| Categorias do conteúdo | Nenhuma. |
|---|---|
| Conteúdo permitido | Conteúdo de fluxo, mas sem descendentes de cabeçalho, rodapé, conteúdo de seção ou conteúdo de cabeçalho. |
| Omissão de tag | A tag de abertura é obrigatória. A tag de fechamento pode ser omitida, se for imediatamente seguido por um <th>,<td> ou se não houver mais dados em seu elemento pai. |
| Elemento pai | Um elemento<tr>. |
| Funções ARIA permitidas | Qualquer |
| DOM interface | HTMLTableHeaderCellElement |
Atributos
Esse elemento inclui osatributos globais.
abbrEste atributo contém uma breve descrição do conteúdo da célula. Alguns usuários-agentes, como leitores, pode apresentar essa descrição antes do próprio conteúdo.
colspanEste atributo contém um valor inteiro não negativo que indica quantas colunas a célula ocupará. Valor padrão
1. Valores acima de 1000 são considerados incorretos e serão modificados para o valor padrão1.headersEste atributo contém uma lista de palavras separadas por espaço, cada uma correspondendo ao atributoid dos elementos
<th>que se aplicam a este elemento.rowspanEste atributo contém um valor inteiro não negativo que indica quantas linhas a célula estende. Valor padrão
1. Se seu valor é definido como0, ele se estende até o final da tabela (<thead>,<tbody>,<tfoot>, mesmo que implicitamente definido), que a célula pertence. Não é possível colocar valores superiores a 65534.scopeEste atributo define as células a que o cabeçalho (definido no elemento
<th>) se relaciona.Possíveis valores:row: O cabeçalho se relaciona com todas as células da linha a que pertence.col: O cabeçalho se relaciona com todas as células da coluna a que pertence.rowgroup: O cabeçalho pertence a um grupo de linhas e se relaciona com todas as suas células. Essas células podem ser colocadas à direita ou à esquerda do cabeçalho, dependendo do valor do atributodirno elemento<table>.colgroup: O cabeçalho pertence a um grupo de colgroup e se relaciona com todas as suas células.auto
O valor padrão quando este atributo não é especificado é
auto.
Atributos depreciados
alignEste atributo especifica como o alinhamento horizontal do conteúdo da célula será tratado.
Possíveis valores:
left: O conteúdo é alinhado a esquerda da célula.center: O conteúdo é centralizado da célula.right: O conteúdo é alinhado a direita da célula.justify(somente com texto): O conteúdo é estendido dentro da célula para cobrir toda a sua largura.char(somente com texto): O conteúdo está alinhado a um caractere dentro do elemento<th>com deslocamento mínimo. Esse caractere é definido pelos atributoscharecharoff.
O valor padrão quando não especificado é
left.**Note:**Não use esse atributo, pois ele está obsoleto no padrão mais recente.- Para alcançar o mesmo efeito que os valores
left,center,rightoujustify, aplique a propriedade CSStext-alignno elemento.- Para alcançar o mesmo efeito que os valor
char, atribue atext-aligno mesmo valor que você usaria parachar.
axisEste atributo contém uma lista de palavras separadas por espaço. Cada palavra é o
idde um grupo de células às quais este cabeçalho se aplica.Nota:Não use esse atributo, pois ele está obsoleto no padrão mais recente: use o atributo
scope.bgcolorNão padrãoEsse atributo define a cor de fundo de cada célula na coluna. Ele consiste de 6 digitos hexadecimais definidos pelosRGB com o prefixo '#. Nesse atributo pode ser usado dezesseis cores predefinidas:
black= "#000000"green= "#008000"silver= "#C0C0C0"lime= "#00FF00"gray= "#808080"olive= "#808000"white= "#FFFFFF"yellow= "#FFFF00"maroon= "#800000"navy= "#000080"red= "#FF0000"blue= "#0000FF"purple= "#800080"teal= "#008080"fuchsia= "#FF00FF"aqua= "#00FFFF"Nota:Não use esse atributo como padrão pois não é implementado em algumas versões do Microsoft Internet Explorer: O elemento
<th>deve ser estilizado usandoCSS. Para criar um efeito semelhante, use a propriedadebackground-colordoCSS.charO conteúdo da célula está alinhado a um caractere. Os valores típicos incluem um ponto (.) para alinhar números ou valores monetários. Se
alignnão está definido nochar, o atributo é ignorado.Nota:Não use esse atributo, pois ele está obsoleto no padrão mais recente. Para obter o mesmo efeito, você pode especificar o caractere como o primeiro valor da propriedade
text-align.charoffEste atributo é usado para mudar os dados da coluna para a direita do caractere especificado pelo atributochar. Seu valor especifica o comprimento desse deslocamento.
**Note:**Não use esse atributo, pois ele está obsoleto no padrão mais recente.
heightDeprecatedEsse atributo é usado para definir uma altura recomendada da célula.
**Note:**Não use esse atributo, pois ele está obsoleto no padrão mais recente: use a propriedade CSS
height.valignEsse atributo especifica como o texto é alinhado verticalmente na célula.
Possíveis valores:
baseline: Posiciona o texto próximo à parte inferior da célula e o alinha aoroda pé. Se os caracteres não descerem abaixo da linha de base, o valor da linha de base alcançará o mesmo efeito quebottom.bottom: Posiciona o texto próximo à parte inferior da célula.middle: Centraliza o texto na célula.top: Posiciona o texto próximo à parte superior da célula.
Nota:Não use esse atributo, pois ele está obsoleto no padrão mais recente: use a propriedade CSS
vertical-align.widthDeprecatedEste atributo é usado para definir uma largura de célula recomendada. Espaço adicional pode ser adicionado com as propriedades
cellspacingecellpadding, e a largura do elemento<col>pode criar largura extra. Mas, se a largura de uma coluna for muito estreita para mostrar uma célula específica corretamente, ela será ampliada quando exibida.Nota:Não use esse atributo, pois ele está obsoleto no padrão mais recente: use a propriedade CSS
width.
Exemplos
Veja<table> para mais elementos<th>.
Especificações
| Specification |
|---|
| HTML> # the-th-element> |