CKTIS / HTML
Atrybut HTML name — znaczenie zależne od elementu
Atrybut `name` nadaje nazwę o znaczeniu zależnym od elementu: klucz danych formularza, nazwę celu nawigacji, mapy obrazu, grupy `details`, slotu lub metadanych. Nie jest atrybutem globalnym ani zamiennikiem `id`.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
name="value"name nie jest atrybutem globalnym: jego znaczenie i ograniczenia zależą od elementu. Nie zastępuje id ani etykiety dostępnej dla użytkownika. W szczególności label[for] wskazuje id kontrolki, a nie jej name.
W kontrolkach formularza name określa nazwę używaną przy wysyłaniu danych i w kolekcji form.elements. Podana wartość nie może być pusta ani równa isindex. Powtarzające się nazwy mogą tworzyć wiele wpisów; wspólna nazwa grupuje też przyciski radio należące do tego samego formularza i drzewa. Zwykłe pole tekstowe bez nazwy nie wnosi wpisu. Sama nazwa nie gwarantuje wysłania: pomijane są m.in. kontrolki wyłączone i niezaznaczone pola checkbox. Unikaj nazw wbudowanych właściwości formularza, np. submit: mogą je przesłonić w DOM.
Na form nazwa służy do dostępu przez document.forms; musi być niepusta i unikatowa w tej kolekcji. Na iframe i, gdy ma to zastosowanie, object nadaje nazwę wewnętrznemu celowi nawigacji przy jego tworzeniu, np. dla target. Musi być poprawną nazwą celu nawigacji. Na map atrybut jest wymagany: nazwa używana przez usemap musi być niepusta, bez białych znaków ASCII i unikatowa w drzewie; podane id musi być identyczne.
Na details wspólna, niepusta nazwa tworzy grupę w tym samym drzewie: otwarcie jednego elementu zamyka pozostałe. Nie zagnieżdżaj członków tej samej grupy ani nie deklaruj kilku otwartych. Rozważ, czy użytkownik nie potrzebuje oglądać kilku sekcji naraz. Na slot nazwa identyfikuje slot w drzewie cienia i jest dopasowywana do atrybutu slot dziecka hosta; może być pustym ciągiem.
Na meta nazwa określa rodzaj metadanych, np. description, a content przechowuje wartość. Nazwy metadanych porównuje się bez uwzględniania wielkości liter ASCII. Nie łącz name z http-equiv, charset ani itemprop na tym samym meta.
Przykłady
<!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>Wynik
[["city","Warsaw"],["tag","html"],["tag","forms"]]
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.