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

* Some parts of this feature may have varying levels of support.

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
# the-th-element

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
th
abbr
align
Deprecated
axis
Deprecated
bgcolor
Deprecated
char
Deprecated
charoff
Deprecated
colspan
headers
rowspan
rowspan attribute with value 0 (extend to the end of the row group)
scope
valign
Deprecated
width
Deprecated

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Deprecated. Not for use in new websites.
See implementation notes.

Veja mais