База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

HTML атрибут name — значение според елемента

Атрибутът `name` задава име според елемента: ключ за данни на формуляр, име на навигационна цел, име на карта на изображение, група `details`, име на слот или име на метаданни. Той не е глобален атрибут и не замества `id`.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

name="value"

name не е глобален атрибут: значението и ограниченията му зависят от елемента. Той не замества id или достъпен етикет, предназначен за потребителя. По-конкретно, label[for] препраща към id на контрола, а не към неговото name.

При контролите на формуляр name задава името, използвано при изпращане и в колекцията form.elements. Посочената стойност не може да е празна или равна на isindex. Повтарящи се имена могат да създадат няколко записа; общото име групира и радио бутоните, принадлежащи към един и същ формуляр и дърво. Обикновено текстово поле без име не добавя запис. Самото име не гарантира изпращане: например деактивираните контроли и непоставените отметки се пропускат. Избягвайте имена на вградени свойства на формуляра, като submit: те могат да прикрият тези свойства в DOM.

При form името позволява търсене чрез document.forms; то трябва да е непразно и уникално в тази колекция. При iframe и, когато е приложимо, object името задава вътрешната навигационна цел при създаването ѝ, например за употреба с target. То трябва да е валидно име на навигационна цел. При map атрибутът е задължителен: името, към което препраща usemap, трябва да е непразно, да не съдържа бели знаци от ASCII и да е уникално в дървото; всяко зададено id трябва да съвпада с него.

При details общо непразно име създава група в същото дърво: отварянето на един член затваря останалите. Не влагайте членове на една и съща група един в друг и не задавайте няколко от тях като отворени. Обмислете дали потребителите трябва да виждат няколко раздела едновременно. При slot името обозначава слот в дърво на сянката и съвпада с атрибута slot на дете на хоста; може да е празен низ.

При meta името обозначава вида метаданни, например description, а content задава стойността им. Имената на метаданните се сравняват без разлика между главни и малки ASCII букви. Не комбинирайте name с http-equiv, charset или itemprop в един и същ meta.

Примери

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

Резултат

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници