Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

optgroup — agrupar opções em select

O elemento `optgroup` reúne elementos `option` dentro de `select` num grupo com nome. Organiza uma lista e permite desativar um grupo inteiro.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<select><optgroup label="Group"><option value="a">A</option></optgroup></select>

optgroup representa um grupo de elementos option com uma etiqueta comum dentro de select. O utilizador seleciona uma opção, não o grupo. Não aninhe grupos optgroup uns dentro dos outros.

O atributo label indica o nome do grupo e é obrigatório se o grupo não tiver um elemento filho legend. A norma atual permite um legend opcional antes do restante conteúdo. Quando é o primeiro filho que é um elemento, o seu texto tem precedência sobre label na determinação do nome do grupo. Para listas simples, use label e elementos option como filhos.

O atributo booleano disabled desativa em conjunto as opções do grupo. O que conta é a sua presença: disabled="false" também desativa o grupo. Para o ativar, remova o atributo. A etiqueta do grupo não substitui a etiqueta do controlo select.

No exemplo, selected define explicitamente a seleção inicial como HTML, enquanto o grupo Unavailable impede a seleção de JavaScript. O aspeto da lista depende do navegador e do sistema operativo; verifique o comportamento, não o aspeto exato.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Option groups</title>
<label for="course">Course</label>
<select id="course" name="course">
  <optgroup label="Available">
    <option value="html" selected>HTML</option>
    <option value="css">CSS</option>
  </optgroup>
  <optgroup label="Unavailable" disabled>
    <option value="js">JavaScript</option>
  </optgroup>
</select>
</html>

Resultado

Initially selected: HTML (value: html). Selectable options: HTML, CSS. Disabled option: JavaScript.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes