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

CKTIS / HTML

switch — um interruptor para input

Nos navegadores que o suportam, o atributo booleano switch transforma um input do tipo checkbox num interruptor de dois estados. O estado ligado ou desligado continua a ser determinado por checked.

Versão: Nonstandard browser extension; not defined by the WHATWG HTML Living Standard.

Sintaxe

<input type="checkbox" switch>

switch aplica-se a input com type="checkbox"; não é um tipo de campo separado. O interruptor tem dois estados, ligado e desligado, determinados por checked. Quando o navegador aplica switch, indeterminate não introduz um terceiro estado. Se o navegador ignorar switch, o controlo continua a ser uma caixa de verificação normal e indeterminate pode alterar o seu aspeto.

É um atributo booleano: as formas válidas são switch, switch="" e switch="switch". Para o desativar, remove o atributo. Escrever switch="false" é inválido e continua a significar que o atributo está presente. Remover switch não é o mesmo que definir checked como false.

No exemplo, uma etiqueta descreve o controlo e o texto abaixo apresenta checked. Verifica separadamente a apresentação do interruptor no navegador de destino; o resultado textual, por si só, não confirma o suporte de switch.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>Switch</title>
<label><input id="setting" type="checkbox" switch checked> Notifications</label>
<pre id="result"></pre>
<script>
  const setting = document.getElementById('setting');
  const result = document.getElementById('result');
  function render() {
    result.textContent = String(setting.checked);
  }
  setting.addEventListener('change', render);
  render();
</script>

Resultado

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