<th>
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 <th>
define uma célula cabeçalho do grupo de células de sua tabela. A exatidão natural deste grupo é definida pelos atributos scope
e headers
.
Experimente
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 os atributos globais.
abbr
-
Este 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.
colspan
-
Este 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
. headers
-
Este atributo contém uma lista de palavras separadas por espaço, cada uma correspondendo ao atributo id dos elementos
<th>
que se aplicam a este elemento. rowspan
-
Este 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. scope
-
Este 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 atributodir
no 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
align
-
Este 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 atributoschar
echaroff
.
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
,right
oujustify
, aplique a propriedade CSStext-align
no elemento.- Para alcançar o mesmo efeito que os valor
char
, atribue atext-align
o mesmo valor que você usaria parachar
.
axis
-
Este atributo contém uma lista de palavras separadas por espaço. Cada palavra é o
id
de 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
. bgcolor
Non-standard-
Esse atributo define a cor de fundo de cada célula na coluna. Ele consiste de 6 digitos hexadecimais definidos pelo sRGB 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 usando CSS. Para criar um efeito semelhante, use a propriedadebackground-color
do CSS. char
-
O 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
align
nã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
. charoff
-
Este atributo é usado para mudar os dados da coluna para a direita do caractere especificado pelo atributo char. Seu valor especifica o comprimento desse deslocamento.
**Note:**Não use esse atributo, pois ele está obsoleto no padrão mais recente.
height
Deprecated-
Esse 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
. valign
-
Esse 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 ao roda 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
. width
Deprecated-
Este atributo é usado para definir uma largura de célula recomendada. Espaço adicional pode ser adicionado com as propriedades
cellspacing
ecellpadding
, 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 Standard # the-th-element |
Compatibilidade com navegadores
BCD tables only load in the browser