<optgroup>

Sumário

Em um Formulário Web, o elemento HTML <optgroup> cria um agrupamento de opções dentro do elemento <select>.

  • Categorias de conteúdo (en-US) Nenhuma.
  • Conteúdo permitido Nenhum ou mais elementos do tipo <option>.
  • Omissão da tag A abertura da tag é obrigatória. O fechamento da tag é opcional se o elemento é imediatamente seguido de de outro elemento <optgroup>, ou se o elemento pai não tiver nenhum conteúdo.
  • Elemento pai permitido Um elemento <select>.
  • Interface DOM HTMLOptGroupElement (en-US)

Nota: Elementos do tipo optgroup não podem ser aninhados.

Atributos

Este elemento inclui os atributos globais (en-US).

disabled

Se este atributo booleano for definido, nenhum dos itens neste optgroup poderá ser selecionado. Muitos navegadores marcam como cinza e não permitem que o elemento receba nenhum evento de navegação, como cliques do mouse ou foco.

label

É o nome do optgroup, é o que os navegadores irão exibir como rótulo. Este atributo é obrigatório se o elemento for usado.

Exemplo

<select>
  <optgroup label="Grupo 1">
    <option>Opção 1.1</option>
  </optgroup>
  <optgroup label="Grupo 2">
    <option>Opção 2.1</option>
    <option>Opção 2.2</option>
  </optgroup>
  <optgroup label="Grupo 3" disabled>
    <option>Opção 3.1</option>
    <option>Opção 3.2</option>
    <option>Opção 3.3</option>
  </optgroup>
</select>

Resultado

Especificações

Especificação Status Comentário
HTML Living Standard
The definition of '<optgroup>' in that specification.		 Padrão em tempo real
HTML5
The definition of '<optgroup>' in that specification.		 Recomendação
HTML 4.01 Specification
The definition of '<optgroup>' in that specification.		 Recomendação

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também