Атрибут имени HTML


Определение и использование

Атрибут nameуказывает имя элемента HTML.

Этот nameатрибут можно использовать для ссылки на элемент в JavaScript.

Для <form>элемента nameатрибут используется в качестве ссылки при отправке данных.

Для <iframe>элемента nameатрибут может использоваться для отправки формы.

Для <map>элемента nameатрибут связан с <img>атрибутом usemapи создает связь между изображением и картой.

Для <meta>элемента nameатрибут указывает имя для информации/значения contentатрибута.

Для <param>элемента nameатрибут используется вместе с valueатрибутом для указания параметров плагина, указанного с помощью <object> тега.


Относится к

Атрибут nameможно использовать для следующих элементов:

Элементы Атрибут
<кнопка> название
<набор полей> название
<форма> название
<iframe> название
<ввод> название
<карта> название
<мета> название
<объект> название
<выход> название
<параметр> название
<выбрать> название
<текстовое поле> название

Примеры

Пример

Две кнопки с одинаковыми именами, которые при нажатии отправляют разные значения:

<form action="/action_page.php" method="get">
  Choose your favorite subject:
  <button name="subject" type="submit" value="HTML">HTML</button>
  <button name="subject" type="submit" value="CSS">CSS</button>
</form>

Пример набора полей

<fieldset> с атрибутом имени:

<fieldset name="personalia">
  Name: <input type="text"><br>
  Email: <input type="text"><br>
</fieldset>

Пример формы

HTML-форма с атрибутом имени:

<form action="/action_page.php" method="get" name="myForm">
  First name: <input type="text" name="fname"><br>
  Last name: <input type="text" name="lname"><br>
  <input type="button" onclick="formSubmit()" value="Send form data!">
</form>

Пример iframe

<iframe>, который действует как цель для ссылки:

<iframe src="demo_iframe.htm" name="iframe_a"></iframe>

<a href="https://www.w3schools.com" target="iframe_a">W3Schools.com</a>

Пример ввода

HTML-форма с тремя полями ввода; два текстовых поля и одна кнопка отправки:

<form action="/action_page.php">
  Name: <input type="text" name="fullname"><br>
  Email: <input type="text" name="email"><br>
  <input type="submit" value="Submit">
</form>

Пример карты

Карта изображения с кликабельными областями:

<img src="planets.gif" width="145" height="126" alt="Planets" usemap="#planetmap">

<map name="planetmap">
  <area shape="rect" coords="0,0,82,126" href="sun.htm" alt="Sun">
  <area shape="circle" coords="90,58,3" href="mercur.htm" alt="Mercury">
  <area shape="circle" coords="124,58,8" href="venus.htm" alt="Venus">
</map>

Мета-пример

Используйте атрибут name для определения описания, ключевых слов и автора HTML-документа:

<head>
<meta name="description" content="Free Web tutorials">
<meta name="keywords" content="HTML,CSS,JavaScript">
<meta name="author" content="Hege Refsnes">
</head>

Пример объекта

Элемент <object> с атрибутом имени:

<object data="helloworld.swf" width="400" height="400" name="obj1"></object>

Пример вывода

Выполните расчет и покажите результат в элементе <output>:

<form oninput="x.value=parseInt(a.value)+parseInt(b.value)">0
  <input type="range" id="a" value="50">100
  +<input type="number" id="b" value="50">
  =<output name="x" for="a b"></output>
</form>

Пример параметра

Установите для параметра «autoplay» значение «true», чтобы звук начал воспроизводиться, как только загрузится страница:

<object data="horse.wav">
  <param name="autoplay" value="true">
</object>

Выберите пример

Выпадающий список с атрибутом имени:

<select name="cars">
  <option value="volvo">Volvo</option>
  <option value="saab">Saab</option>
  <option value="opel">Opel</option>
  <option value="audi">Audi</option>
</select>

Пример текстовой области

Текстовая область с атрибутом имени:

<form action="/action_page.php">
  <textarea name="comment">Enter text here...</textarea>
  <input type="submit">
</form>

Поддержка браузера

Атрибут multipleимеет следующую поддержку браузера для каждого элемента:

Element
button Yes Yes Yes Yes Yes
fieldset Yes Not supported Yes Yes Yes
form Yes Yes Yes Yes Yes
iframe Yes Yes Yes Yes Yes
input 1.0 2.0 1.0 1.0 1.0
map Yes Yes Yes Yes Yes
meta Yes Yes Yes Yes Yes
object Yes Yes Yes Yes Yes
output 10.0 Not supported 4.0 5.1  11.0
param Yes Yes Yes Yes Yes
select Yes Yes Yes Yes Yes
textarea Yes Yes Yes Yes Yes