CKTIS / HTML
HTML atribut name — značenje ovisno o elementu
Atribut `name` daje naziv ovisan o elementu: ključ podataka obrasca, naziv navigacijskog cilja, naziv slikovne mape, grupu `details`, naziv slota ili naziv metapodataka. Nije globalni atribut ni zamjena za `id`.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
name="value"name nije globalni atribut: njegovo značenje i ograničenja ovise o elementu. Ne zamjenjuje id ni pristupačnu oznaku namijenjenu korisniku. Konkretno, label[for] upućuje na id kontrole, a ne na njezin name.
Na kontrolama obrasca name određuje naziv koji se koristi pri slanju i u kolekciji form.elements. Navedena vrijednost ne smije biti prazna ni jednaka isindex. Ponavljajući nazivi mogu stvoriti više unosa; zajednički naziv grupira i izborne gumbe koji pripadaju istom obrascu i stablu. Obično tekstno polje bez naziva ne stvara unos. Sam naziv ne jamči slanje: onemogućene kontrole i nepotvrđeni potvrdni okviri, primjerice, izostavljaju se. Izbjegavajte nazive ugrađenih svojstava obrasca, kao što je submit: u DOM-u mogu zasjeniti ta svojstva.
Na form naziv omogućuje dohvat putem document.forms; mora biti neprazan i jedinstven unutar te kolekcije. Na iframe i, gdje je primjenjivo, object pri stvaranju imenuje unutarnji navigacijski cilj, primjerice za uporabu s target. Mora biti valjan naziv navigacijskog cilja. Na map atribut je obavezan: naziv na koji upućuje usemap mora biti neprazan, ne smije sadržavati ASCII razmake i mora biti jedinstven u svom stablu; svaki navedeni id mora mu odgovarati.
Na details zajednički neprazan naziv stvara grupu u istom stablu: otvaranje jednog člana zatvara ostale. Nemojte ugnijezditi članove iste grupe ni označiti više članova kao otvorene. Razmotrite trebaju li korisnici istodobno pregledavati više odjeljaka. Na slot naziv označava slot u stablu sjene i podudara se s atributom slot djeteta domaćina; može biti prazan niz.
Na meta naziv označava vrstu metapodatka, kao što je description, dok content daje njegovu vrijednost. Nazivi metapodataka uspoređuju se bez razlikovanja ASCII velikih i malih slova. Nemojte kombinirati name s http-equiv, charset ili itemprop na istom meta.
Primjeri
<!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>Rezultat
[["city","Warsaw"],["tag","html"],["tag","forms"]]
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.