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

CKTIS / HTML

Atributo HTML name — significado específico do elemento

O atributo `name` fornece um nome específico do elemento: uma chave de dados do formulário, um nome de destino de navegação, um nome de mapa de imagem, um grupo `details`, um nome de slot ou um nome de metadados. Não é global nem substitui `id`.

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

Sintaxe

name="value"

name não é um atributo global: o seu significado e as suas restrições dependem do elemento. Não substitui id nem um rótulo acessível destinado ao utilizador. Em particular, label[for] faz referência ao id de um controlo, não ao seu name.

Nos controlos de formulário, name fornece o nome utilizado no envio e na coleção form.elements. O valor especificado não pode estar vazio nem ser isindex. Nomes repetidos podem produzir várias entradas; um nome partilhado também agrupa botões de opção pertencentes ao mesmo formulário e árvore. Um campo de texto normal sem nome não contribui com nenhuma entrada. O nome, por si só, não garante o envio: por exemplo, os controlos desativados e as caixas de verificação não selecionadas são omitidos. Evite nomes de propriedades incorporadas dos formulários, como submit: podem ocultar essas propriedades no DOM.

Em form, o nome permite a pesquisa através de document.forms; tem de ser não vazio e único nessa coleção. Em iframe e, quando aplicável, object, dá nome ao destino de navegação interno quando este é criado, por exemplo para utilização com target. Tem de ser um nome válido de destino navegável. Em map, o atributo é obrigatório: o nome referenciado por usemap tem de ser não vazio, não conter espaços em branco ASCII e ser único na sua árvore; qualquer id especificado tem de corresponder-lhe.

Em details, um nome partilhado não vazio cria um grupo na mesma árvore: abrir um membro fecha os restantes. Não aninhe membros do mesmo grupo nem declare vários membros abertos. Pondere se os utilizadores precisam de ver várias secções em simultâneo. Em slot, o nome identifica um slot numa árvore de sombra e corresponde ao atributo slot de um elemento filho do anfitrião; pode ser uma cadeia vazia.

Em meta, o nome identifica o tipo de metadado, como description, enquanto content fornece o valor. Os nomes dos metadados são comparados sem distinção entre maiúsculas e minúsculas ASCII. Não combine name com http-equiv, charset ou itemprop no mesmo meta.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>name example</title>
<form id="profile" name="profileForm">
  <label>City <input id="city" name="city" value="Warsaw"></label>
  <input name="tag" value="html" type="hidden">
  <input name="tag" value="forms" type="hidden">
  <label>Ignored <input value="not submitted"></label>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById("profile");
  const pairs = [...new FormData(form).entries()];
  document.getElementById("result").textContent = JSON.stringify(pairs);
</script>
</html>

Resultado

[["city","Warsaw"],["tag","html"],["tag","forms"]]

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