O elemento HTML <th>
define uma célula cabeçalho do grupo de células de sua tabela. A exatidão natural deste grupo é denifida pelos atributos scope
e headers
.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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
Obsolete since HTML5- 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
. Unimplemented no CSS3.
- Para alcançar o mesmo efeito que os valores
axis
Obsolete since HTML5- 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.Note: Não use esse atributo, pois ele está obsoleto no padrão mais recente: use o atributoscope
. bgcolor
- 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"Note: 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
Obsolete since HTML5- 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.Note: 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 propriedadetext-align
, Unimplemented no CSS3. charoff
Obsolete since HTML5- 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 since HTML4, Obsolete since HTML5- 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
Obsolete since HTML5- 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.
Note: Não use esse atributo, pois ele está obsoleto no padrão mais recente: use a propriedade CSSvertical-align
. width
Deprecated since HTML4, Obsolete since HTML5- 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.Note: Não use esse atributo, pois ele está obsoleto no padrão mais recente: use a propriedade CSSwidth
.
Exemplos
Veja <table>
para mais elementos <th>
.
Especificações
Especificações | Estados | Comentário |
---|---|---|
HTML Living Standard The definition of 'th element' in that specification. |
Padrão em tempo real | |
HTML5 The definition of 'th element' in that specification. |
Recomendação |
Compatibilidade com navegadores
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.