<option>

Sumário

Em um formulário Web, o elemento HTML <option> é usado para criar um controle que representa um item dentro de um elemento HTML5 <select>, <optgroup> ou <datalist>.

  • Categorias de conteúdo Nenhuma.
  • Conteúdo permitido Texto com caracteres escapados (como &eacute;) ocasionalmente.
  • Omissão de tags A tag de abertura é obrigatória. A tag de fechamento é opcional se este elemento é imediatamente seguido por um outro elemento <option> ou um <optgroup>, ou se o elemento pai não tem mais nenhum conteúdo.
  • Elementos pai permitidos <select>, <optgroup> ou <datalist>.
  • Interface DOM HTMLOptionElement

Atributos

Este elemento inclui os atributos globais.

disabled

Se este atributo booleano estiver definido, esta opção não é selecionável. Frequentemente navegadores acinzentam este tipo de controle, e ele deixa de receber quaisquer eventos de navegação, como cliques do mouse ou eventos relacionados a foco. Se este atributo não estiver definido, o elemento ainda pode ser desabilitado se um de seus ancestrais é um elemento <optgroup> desabilitado.

label

Este atributo é o texto para o rótulo indicando o significado da opção. Se o atributo label não estiver definido, seu valor é o conteúdo de texto do elemento.

Note: Nota de uso: o atributo label é projetado para conter um rótulo curto tipicamente usado num menu hierárquico. O atributo value descreve descreve um rótulo maior, designado para ser usado perto de um botão de escolha, por exemplo.

selected

Se presente, este atributo booleano indica que a opção está selecionada inicialmente. Se o elemento <option> for descendente de um elemento <select> cujo atributo multiple não está definido, apenas um único <option> deste elemento <select> pode ter o atributo selected.

value

O conteúdo textual deste atributo representa o rótulo que explica a opção. Se ele não estiver definido, seu valor padrão é o texto contido no elemento.

Note: Nota de uso: o atributo label é projetado para conter um rótulo curto tipicamente usado num menu hierárquico. O atributo value descreve descreve um rótulo maior, designado para ser usado perto de um botão de escolha, por exemplo.

Exemplos

Veja os exemplos do elemento <select>.

Especificações

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também