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

CKTIS / HTML

label — rótulo de um controlo

O elemento `label` atribui um rótulo a um controlo. Associe-os através de `for` e `id`, ou coloque o controlo dentro do rótulo.

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

Sintaxe

<label for="control-id">Caption</label>
<input id="control-id">

<label>Caption <input></label>

label representa um rótulo da interface do utilizador. O seu atributo for aponta para o id de um elemento etiquetável na mesma árvore, e não para o seu name. Se for estiver ausente, é apontado o primeiro descendente etiquetável; um for inválido não ativa este mecanismo como alternativa.

Não aninhe elementos label nem coloque dentro deles controlos etiquetáveis adicionais. Um input com type="hidden" não é etiquetável. Um controlo pode ter vários rótulos. São necessárias ambas as etiquetas label.

Clicar num rótulo pode ativar o controlo associado, mas o comportamento depende da plataforma. A propriedade DOM label.control devolve o controlo associado ou null.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Label association</title>
<label for="email">Email</label>
<input id="email" type="email">
<script>
  const label = document.querySelector('label');
  const input = document.querySelector('input');
  console.log(label.control === input);
</script>
</html>

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