<th>

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 scopeheaders.

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ão 1.
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 como 0, 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 atributo dir 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 atributos char e charoff.

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 ou justify, aplique a propriedade CSS text-align no elemento.
  • Para alcançar o mesmo efeito que os valor char, atribue a text-align  o mesmo valor que você usaria para char. Unimplemented no CSS3.
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 atributo scope.
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 propriedade background-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 no char, 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 propriedade text-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 que bottom.
  • 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 CSS vertical-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 cellspacingcellpadding, 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 CSS width.

Exemplos

Veja <table> para mais elementos <th>.

Especificações

Compatibilidade com navegadores

BCD tables only load in the browser

Veja mais