CKTIS / HTML
Atribút HTML name — význam podľa prvku
Atribút `name` poskytuje názov špecifický pre daný prvok: kľúč formulárových údajov, názov cieľa navigácie, názov obrazovej mapy, skupinu `details`, názov slotu alebo názov metadát. Nie je globálny a nenahrádza `id`.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
name="value"name nie je globálny atribút: jeho význam a obmedzenia závisia od prvku. Nenahrádza id ani prístupný popis určený používateľovi. Najmä label[for] odkazuje na id ovládacieho prvku, nie na jeho name.
Pri ovládacích prvkoch formulára určuje name názov použitý pri odosielaní a v kolekcii form.elements. Zadaná hodnota nesmie byť prázdna ani rovná isindex. Opakované názvy môžu vytvoriť viac položiek; spoločný názov tiež zoskupuje prepínače, ktoré patria do toho istého formulára a stromu. Bežné textové pole bez názvu nevytvorí žiadnu položku. Samotný názov odoslanie nezaručuje: napríklad zakázané ovládacie prvky a nezačiarknuté políčka sa vynechajú. Vyhnite sa názvom vstavaných vlastností formulára, ako je submit: v DOM môžu tieto vlastnosti zatieniť.
Pri form umožňuje názov vyhľadávanie cez document.forms; musí byť neprázdny a v tejto kolekcii jedinečný. Pri iframe a, ak je to relevantné, object pomenúva pri vytvorení vnútorný navigačný cieľ, napríklad na použitie s target. Musí ísť o platný názov navigovateľného cieľa. Pri map je atribút povinný: názov, na ktorý odkazuje usemap, musí byť neprázdny, nesmie obsahovať ASCII biele znaky a musí byť v danom strome jedinečný; prípadné zadané id sa mu musí rovnať.
Pri details vytvára spoločný neprázdny názov skupinu v tom istom strome: otvorenie jedného člena zavrie ostatné. Členov rovnakej skupiny nevnárajte a neoznačujte viac členov ako otvorených. Zvážte, či používatelia potrebujú naraz zobrazovať viacero sekcií. Pri slot názov identifikuje slot v strome tieňového DOM a zodpovedá atribútu slot potomka hostiteľa; môže byť prázdnym reťazcom.
Pri meta názov určuje druh metadát, napríklad description, zatiaľ čo content poskytuje ich hodnotu. Názvy metadát sa porovnávajú bez rozlišovania veľkosti ASCII písmen. Nekombinujte name s http-equiv, charset ani itemprop na tom istom meta.
Príklady
<!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>Výsledok
[["city","Warsaw"],["tag","html"],["tag","forms"]]
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.