Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

Attribut HTML name — signification propre à l’élément

L’attribut `name` fournit un nom propre à l’élément : clé de données de formulaire, nom de cible de navigation, nom de carte d’image, groupe `details`, nom de slot ou nom de métadonnée. Ce n’est ni un attribut global ni un remplacement de `id`.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

name="value"

name n’est pas un attribut global : sa signification et ses contraintes dépendent de l’élément. Il ne remplace ni id ni un libellé accessible destiné à l’utilisateur. En particulier, label[for] fait référence à l’id d’un contrôle, pas à son name.

Sur les contrôles de formulaire, name fournit le nom utilisé lors de l’envoi et dans la collection form.elements. Une valeur spécifiée ne doit être ni vide ni égale à isindex. Des noms répétés peuvent produire plusieurs entrées ; un nom commun regroupe aussi les boutons radio appartenant au même formulaire et au même arbre. Un champ texte ordinaire sans nom ne produit aucune entrée. Un nom ne garantit pas à lui seul l’envoi : les contrôles désactivés et les cases à cocher non cochées, par exemple, sont omis. Évitez les noms de propriétés intégrées des formulaires, comme submit : ils peuvent masquer ces propriétés dans le DOM.

Sur form, le nom permet la recherche via document.forms ; il doit être non vide et unique dans cette collection. Sur iframe et, le cas échéant, object, il nomme la cible de navigation interne lors de sa création, par exemple pour l’utiliser avec target. Il doit s’agir d’un nom de cible navigable valide. Sur map, l’attribut est obligatoire : le nom référencé par usemap doit être non vide, ne contenir aucun espace blanc ASCII et être unique dans son arbre ; tout id spécifié doit lui correspondre.

Sur details, un nom commun non vide crée un groupe dans le même arbre : l’ouverture d’un membre ferme les autres. N’imbriquez pas les membres d’un même groupe et n’en déclarez pas plusieurs ouverts. Demandez-vous si les utilisateurs doivent pouvoir consulter plusieurs sections simultanément. Sur slot, le nom identifie un slot dans un arbre fantôme et correspond à l’attribut slot d’un enfant de l’hôte ; il peut être une chaîne vide.

Sur meta, le nom identifie le type de métadonnée, comme description, tandis que content en fournit la valeur. Les noms de métadonnées sont comparés sans distinction de casse ASCII. Ne combinez pas name avec http-equiv, charset ou itemprop sur le même meta.

Exemples

<!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>

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources