Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

Atribut HTML name — pomen glede na element

Atribut `name` določa ime glede na element: ključ podatkov obrazca, ime navigacijskega cilja, ime slikovne karte, skupino `details`, ime reže ali ime metapodatkov. Ni globalni atribut in ne nadomešča `id`.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

name="value"

name ni globalni atribut: njegov pomen in omejitve so odvisni od elementa. Ne nadomešča id ali dostopne oznake, namenjene uporabniku. Zlasti label[for] se sklicuje na id kontrolnika, ne na njegov name.

Pri kontrolnikih obrazca name določa ime, uporabljeno pri pošiljanju in v zbirki form.elements. Navedena vrednost ne sme biti prazna ali enaka isindex. Ponavljajoča se imena lahko ustvarijo več vnosov; skupno ime združuje tudi izbirne gumbe, ki pripadajo istemu obrazcu in drevesu. Običajno besedilno polje brez imena ne prispeva vnosa. Samo ime ne zagotavlja pošiljanja: onemogočeni kontrolniki in neoznačena potrditvena polja so na primer izpuščeni. Izogibajte se imenom vgrajenih lastnosti obrazca, kot je submit: v DOM lahko prekrijejo te lastnosti.

Pri form ime omogoča iskanje prek document.forms; ne sme biti prazno in mora biti v tej zbirki enolično. Pri iframe in, kjer je ustrezno, object ob nastanku poimenuje notranji navigacijski cilj, na primer za uporabo z target. Biti mora veljavno ime navigacijskega cilja. Pri map je atribut obvezen: ime, na katero se sklicuje usemap, mora biti neprazno in enolično v svojem drevesu ter ne sme vsebovati belih znakov ASCII. Če je naveden tudi id, mora biti enak temu imenu.

Pri details skupno neprazno ime ustvari skupino v istem drevesu: ko odprete enega od članov, se drugi zaprejo. Članov iste skupine ne gnezdite in ne določite več odprtih članov. Premislite, ali morajo uporabniki hkrati videti več razdelkov. Pri slot ime označuje režo v drevesu senčnega DOM in se ujema z atributom slot otroka gostitelja; lahko je prazen niz.

Pri meta ime označuje vrsto metapodatkov, na primer description, vrednost pa poda content. Imena metapodatkov se primerjajo brez upoštevanja velikosti črk ASCII. Na istem meta ne kombinirajte name z http-equiv, charset ali itemprop.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri