<hgroup>
Experimental: Esta é uma tecnologia experimental (en-US)
Verifique a tabela de compatibilidade entre Navegadores cuidadosamente antes de usar essa funcionalidade em produção.
O **elemento HTML <hgroup>
**destina-se a agrupar cabeçalhos de diferentes níveis para uma seção do documento. Ele agrupa (é um container para) um conjunto de elementos <h1>–<h6>
.
Categorias de conteudo | Flow content (en-US), heading content, palpable content. |
---|---|
Conteúdo permitido |
One or more <h1> (en-US), <h2> (en-US),
<h3> (en-US), <h4> (en-US),
<h5> (en-US), and/or <h6> (en-US).
|
Omissão de tag | None, both the starting and ending tag are mandatory. |
Elementos-pai permitidos |
Any element that accepts flow content (en-US). |
DOM interface | HTMLElement |
atributos
Esse elemento admite apenas os global attributes (en-US) (atributos globais)
Notas sobre o uso
Note: O elemento
<hgroup>
foi removido da especificação do W3C para a HTML5, mas ainda se encontra na especificação HTML do WHATWG. Foi parcialmente implementado na maioria dos navegadores, contudo é pouco provável que seja incluído na especificação. Considerando que a finalidade do elemento<hgroup>
é a de definir a maneira como os títulos serão mostrados pelo outline algorithm definido na especificação da HTML (en-US) e considerando ainda que o outline algorithm da HTML não está implementado em nenhum navegador, conclui-se que, na prática, a semântica do elemento<hgroup>
é meramente teórica. A especificação do W3C para a HTML5 fornece algumas sugestões para a marcação de Subheadings, subtitles, alternative titles and taglines sem que se use o elemento<hgroup>
.
O elemento <hgroup> permite que o cabeçalho principal de uma seção de documento seja agrupado com quaisquer cabeçalhos secundarios-como subtitulos ou titulos alternativos-para formatar um cabeçalho de varios niveis.
Em outras palavras o elemento <hgroup> impede que qualquer um dos seus filhos secundarios <h1>-<h6> crie seçoes separadas propias no esboço-como esses elementos <h1>-<h6> normalmene seriam se não fossem filhos de nenhum <hgroup>
Então, no esboço abstrato produzida pelo algortimo abstrato do HTML definido na especificação HTML, o <hgroup> como um todo forma uma posição lógica simples, com todo o conjunto de filhos <h1>-<h6> do <hgroup> entrando no esquema como uma unidade multinível, para compreender esse cabeçalho lógico único no resumo abstrato.
Para produzir alguma (não-abstrato) visualização não renderizada como um esboço, alguma escolhe deve ser feita no design para renderizar ferramentas sobre como renderizar <hgroup> cabeçalhos como um jeito para transmitir sua natureza multi-nível. Há uma varidade de jeitos que <hgroup> pode ser mostrado em um esboço renderizado; por exemplo:
- um <hgroup> pode ser mostrado em um esboço renderizado com dois pontos e espaço (": ") ou outra pontuação após o cabeçalho principal e antes do primeiro cabeçalho secundário (e como a mesma pontuaçã, ou parecida, antes de qualquer cabeçalho secundário).
- um <hgroup> pode ser mostrado em um esboço renderizado com o primeiro cabeçalho seguido de parênteses ao redor do segundo cabeçalho (s).
Considere o documento HTML a seguir:
<!DOCTYPE html>
<title>HTML Standard</title>
<body>
<hgroup id="document-title">
<h1>HTML</h1>
<h2>Living Standard — Last Updated 12 August 2016</h2>
</hgroup>
<p>Some intro to the document.</p>
<h2>Table of contents</h2>
<ol id=toc>...</ol>
<h2>First section</h2>
<p>Some intro to the first section.</p>
</body>
Um esboço renderizado para esse documento seria como:
Isso é, o esboço renderizado deve ser o título primário, HTML, seguido por dois pontos e espaço, seguido pelo título secundário, Living Standard - Last Update 12 August 2016.
Ou, o esboço renderizado para aquele documento poderia ser como:
Isso é, o esboço renderizado deve mostrar o título primário, HTML, seguido pelo título secundário mostrado entre parênteses: (Living Standard - Last Updated 12 August 2016).
Exemplos
<hgroup id="document-title">
<h1>HTML</h1>
<h2>Living Standard — Last Updated 12 August 2016</h2>
</hgroup>
Specification | Status | Comment |
---|---|---|
HTML Living Standard The definition of '<hgroup>' in that specification. |
Padrão em tempo real |
Compatibilidade com navegadores
BCD tables only load in the browser
See also
- Others section-related elements:
<body>
,<article>
,<section>
,<aside>
,<h1>
(en-US),<h2>
(en-US),<h3>
(en-US),<h4>
(en-US),<h5>
(en-US),<h6>
(en-US),<nav>
,<header>
,<footer>
,<address>
; - Sections and outlines of an HTML5 document.