<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ã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

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.
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 propriedade background-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 no char, 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 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.

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 e cellpadding, 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

Veja mais