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

CategoriaTabelas
Modelo de ConteúdoConteúdo de fluxo
Pais PermitidosQualquer elemento que aceite conteúdo de fluxo
Tag de FechamentoSim — requer fechamento </colgroup> tag
StatusPadrão

📝 Sintaxe

<colgroup>
  <col>
</colgroup>

⚙️ Atributos

Este elemento suporta os atributos globais mais os seguintes:

AtributoValorDescrição
spanColumns 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 ChromeChrome EdgeEdge FirefoxFirefox SafariSafari OperaOpera
<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.
Mais estudos de caso em breve — volte mais tarde.

📚 Tutoriais Relacionados

Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%