<th>
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 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
<table>
<caption>
Alien football stars
</caption>
<tr>
<th scope="col">Player</th>
<th scope="col">Gloobles</th>
<th scope="col">Za'taak</th>
</tr>
<tr>
<th scope="row">TR-7</th>
<td>7</td>
<td>4,569</td>
</tr>
<tr>
<th scope="row">Khiresh Odo</th>
<td>7</td>
<td>7,223</td>
</tr>
<tr>
<th scope="row">Mia Oolong</th>
<td>9</td>
<td>6,219</td>
</tr>
</table>
th,
td {
border: 1px solid rgb(160 160 160);
padding: 8px 10px;
}
th[scope="col"] {
background-color: #505050;
color: #fff;
}
th[scope="row"] {
background-color: #d6ecd4;
}
td {
text-align: center;
}
tr:nth-of-type(even) {
background-color: #eee;
}
table {
border-collapse: collapse;
border: 2px solid rgb(140 140 140);
font-family: sans-serif;
font-size: 0.8rem;
letter-spacing: 1px;
}
caption {
caption-side: bottom;
padding: 10px;
}
| 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 atributodirno 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 atributoscharecharoff.
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,rightoujustify, aplique a propriedade CSStext-alignno elemento.- Para alcançar o mesmo efeito que os valor
char, atribue atext-aligno mesmo valor que você usaria parachar.
axis-
Este atributo contém uma lista de palavras separadas por espaço. Cada palavra é o
idde 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. bgcolorNão padrão-
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-colordo 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
alignnã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.
heightDeprecated-
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. widthDeprecated-
Este atributo é usado para definir uma largura de célula recomendada. Espaço adicional pode ser adicionado com as propriedades
cellspacingecellpadding, 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
Loading…