Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

Atribut HTML name — význam podle prvku

Atribut `name` poskytuje název specifický pro daný prvek: klíč formulářových dat, název cíle navigace, název obrazové mapy, skupinu `details`, název slotu nebo název metadat. Není globální a nenahrazuje `id`.

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

Syntaxe

name="value"

name není globální atribut: jeho význam a omezení závisejí na prvku. Nenahrazuje id ani přístupný popisek určený uživateli. Zejména label[for] odkazuje na id ovládacího prvku, nikoli na jeho name.

U formulářových ovládacích prvků určuje name název použitý při odesílání a v kolekci form.elements. Zadaná hodnota nesmí být prázdná ani rovna isindex. Opakované názvy mohou vytvořit více položek; společný název také seskupuje přepínače patřící do stejného formuláře a stromu. Běžné textové pole bez názvu nevytvoří žádnou položku. Samotný název odeslání nezaručuje: například zakázané ovládací prvky a nezaškrtnutá políčka jsou vynechány. Vyhněte se názvům vestavěných vlastností formuláře, jako je submit: v DOM mohou tyto vlastnosti zastínit.

U form umožňuje název vyhledání přes document.forms; musí být neprázdný a v této kolekci jedinečný. U iframe a případně také object pojmenovává při vytvoření vnitřní navigační cíl, například pro použití s target. Musí jít o platný název navigovatelného cíle. U map je atribut povinný: název, na který odkazuje usemap, musí být neprázdný, nesmí obsahovat ASCII bílé znaky a musí být v daném stromu jedinečný; případné zadané id se mu musí rovnat.

U details vytváří společný neprázdný název skupinu ve stejném stromu: otevření jednoho člena zavře ostatní. Členy stejné skupiny nevnořujte a neoznačujte jako otevřených více členů. Zvažte, zda uživatelé potřebují zobrazit několik oddílů současně. U slot název označuje slot ve stromu stínového DOM a odpovídá atributu slot potomka hostitele; může být prázdným řetězcem.

U meta název určuje druh metadat, například description, zatímco content poskytuje jejich hodnotu. Názvy metadat se porovnávají bez rozlišování velikosti ASCII písmen. Nekombinujte name s http-equiv, charset ani itemprop na stejném meta.

Pří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ýsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje