<colgroup>: O Elemento COLGROUP
Última atualização: 2026-10-13
<colgroup>O Elemento COLGROUP
Um contêiner que agrupa colunas de tabela, envolvendo elementos col para definir estilos de coluna em massa.
| Categoria | Tabelas |
|---|---|
| Modelo de Conteúdo | Conteúdo de fluxo |
| Pais Permitidos | Qualquer elemento que aceite conteúdo de fluxo |
| Tag de Fechamento | Sim — requer fechamento </colgroup> tag |
| Status | Padrão |
📝 Sintaxe
<colgroup>
<col>
</colgroup>
⚙️ Atributos
Este elemento suporta os atributos globais mais os seguintes:
| Atributo | Valor | Descrição |
|---|---|---|
span | Columns covered when no col children are present. |
▶ Exemplo
Edite o código abaixo e veja o resultado em tempo real no playground:
🌐 Suporte de Navegadores
| Navegador | |||||
|---|---|---|---|---|---|
| <colgroup> | ✓ v1 | ✓ v12 | ✓ v1 | ✓ v1 | ✓ v1 |
| Suportado em todos os navegadores principais | |||||
Dica: Quando há filhos col, o span de colgroup é ignorado; coloque-o após caption, antes de thead.
❓ Perguntas Frequentes
Qcolgroup é obrigatório?
ANão;
<col> pode ficar direto sob a table, mas a especificação recomenda embrulhar em <colgroup> — estrutura mais clara e amigável ao validador. Para agrupar colunas e estilizá-las em conjunto (primeiras colunas com um fundo, demais com outro), colgroup é o único caminho correto.QOnde colgroup fica dentro de table?
ALogo depois de
<caption> e antes de qualquer conteúdo de linhas (thead/tbody/tr), posição fixa: <table><caption>…</caption><colgroup>…</colgroup><thead>…</thead></table>. Fora de ordem, o parser ajusta ou o validador reclama.QEntre colgroup e th, qual width prevalece?
AA definição no nível de coluna (width de col/colgroup) pode conflitar com a da célula; na regra do navegador, a largura definida no col prevalece para a coluna inteira, podendo ser estourada por células com conteúdo largo demais. Na prática, defina as larguras num único lugar (normalmente colgroup) e evite misturar.
🏷️ Tags Relacionadas
💡 Casos Relacionados
Mais estudos de caso em breve — volte mais tarde.