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

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.

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 de navegadores

Notas do Gecko

[1] Antes do Gecko 7.0, (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4), o atributo label devolvia incorretamente uma string vazia, se não definido, em vez de devolver o texto contido no elemento.

Veja também

• Outros elementos relacionados a formulários: <form>, <legend>, <label>, <button>, <select>, <datalist>, <optgroup>, <fieldset>, <textarea>, <keygen>, <input>, <output>, <progress> e <meter>.