CKTIS / HTML
Attributo HTML name — significato specifico dell’elemento
L’attributo `name` fornisce un nome specifico dell’elemento: una chiave per i dati del modulo, un nome di destinazione di navigazione, un nome di mappa immagine, un gruppo `details`, un nome di slot o un nome di metadati. Non è globale né sostituisce `id`.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
name="value"name non è un attributo globale: il suo significato e i suoi vincoli dipendono dall’elemento. Non sostituisce id né un’etichetta accessibile rivolta all’utente. In particolare, label[for] fa riferimento all’id di un controllo, non al suo name.
Nei controlli del modulo, name fornisce il nome usato per l’invio e nella raccolta form.elements. Il valore specificato non può essere vuoto né uguale a isindex. Nomi ripetuti possono generare più voci; un nome condiviso raggruppa anche i pulsanti radio appartenenti allo stesso modulo e albero. Un normale campo di testo senza nome non aggiunge alcuna voce. Il solo nome non garantisce l’invio: per esempio, i controlli disabilitati e le caselle non selezionate vengono omessi. Evita nomi di proprietà integrate dei moduli, come submit: possono nascondere tali proprietà nel DOM.
Su form, il nome consente di trovare il modulo tramite document.forms; deve essere non vuoto e univoco nella raccolta. Su iframe e, se applicabile, object, assegna un nome alla destinazione di navigazione interna al momento della sua creazione, per esempio per usarla con target. Deve essere un nome valido per una destinazione navigabile. Su map, l’attributo è obbligatorio: il nome a cui fa riferimento usemap deve essere non vuoto, non contenere spazi bianchi ASCII ed essere univoco nel suo albero; ogni id specificato deve corrispondere.
Su details, un nome condiviso non vuoto crea un gruppo nello stesso albero: l’apertura di un membro chiude gli altri. Non annidare membri dello stesso gruppo e non dichiararne più di uno aperto. Valuta se gli utenti devono poter vedere più sezioni contemporaneamente. Su slot, il nome identifica uno slot in un albero ombra e corrisponde all’attributo slot di un figlio dell’host; può essere una stringa vuota.
Su meta, il nome identifica il tipo di metadato, come description, mentre content ne fornisce il valore. I nomi dei metadati vengono confrontati senza distinzione tra maiuscole e minuscole ASCII. Non combinare name con http-equiv, charset o itemprop sullo stesso meta.
Esempi
<!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>Risultato
[["city","Warsaw"],["tag","html"],["tag","forms"]]
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.