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

CKTIS / HTML

selected — seleção predefinida de uma opção

O atributo booleano selected especifica a seleção predefinida de um elemento option. Não é uma forma fiável de obter a escolha atual: em JavaScript, selected descreve o estado atual, enquanto defaultSelected reflete o atributo.

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

Sintaxe

<option selected>...</option>
<option selected="">...</option>
<option selected="selected">...</option>

selected é um atributo booleano de um elemento option que especifica a respetiva seleção predefinida. Coloca-o em option, não em select. Sem multiple, um elemento select não deve conter mais do que uma opção com este atributo; com multiple, são permitidas várias seleções predefinidas.

As formas selected, selected="" e selected="selected" são equivalentes. Escrever selected="false" é inválido e significa, ainda assim, que o atributo está presente. Para remover a seleção predefinida, omite ou remove o atributo.

Em JavaScript, option.defaultSelected reflete o atributo, enquanto option.selected indica a seleção atual. Uma alteração da seleção pelo utilizador ou uma atribuição a option.selected define uma sinalização interna de alteração (dirtiness); a partir daí, alterar o atributo deixa de controlar diretamente a seleção dessa opção. Usa option.selected ou select.value para alterar a escolha atual.

form.reset() restaura as seleções com base nos atributos selected atuais, limpa as sinalizações de alteração e aplica as regras de seleção do elemento select. A ausência do atributo não garante que não exista uma seleção atual: uma lista pendente normal pode selecionar automaticamente a primeira opção ativada.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>selected</title>
<form id="demo">
  <label for="color">Color</label>
  <select id="color" name="color">
    <option value="red">Red</option>
    <option value="blue" selected>Blue</option>
  </select>
</form>
<pre id="output"></pre>
<script>
  const form = document.getElementById('demo');
  const select = document.getElementById('color');
  const blue = select.options[1];
  const lines = [];
  function record() {
    lines.push(`${select.value} ${blue.selected} ${blue.defaultSelected}`);
  }
  record();
  select.value = 'red';
  record();
  form.reset();
  record();
  document.getElementById('output').textContent = lines.join('\n');
</script>

Resultado

blue true true
red false true
blue true true

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