Параметры input. Описание параметров тега

13.04.2019 Windows 8

Описание

HTML тег - является пустым элементом и содержит только атрибуты. Используется в пределах элемента

, объявляя элементы управления для пользовательского ввода, которые позволяют пользователю вводить различные данные. Связать текст с определенным элементом формы(сделать его активным) можно с помощью тега .

Поля для пользовательского ввода могут значительно отличаться друг от друга. В зависимости от значения атрибута type, поле ввода может быть текстовым полем, полем для пароля, радио кнопкой, простой кнопкой и тд.

Атрибуты

accept: Указывает типы файлов, которые могут быть переданы на сервер через поле загрузки файлов. Если тип загружаемого файла не совпадает ни с одним из типов файлов, указанных в значении, то файл будет игнорироваться. При указании нескольких значений, они должны разделяться запятой. Атрибут accept работает только совместно с атрибутом type="file", его возможные значения:

audio/* - принимаются все звуковые файлы.
video/* - принимаются все видео файлы.
image/* - принимаются все файлы изображений.
MIME_тип - принимается допустимый MIME-тип без параметров.

Совет: не рекомендуется использовать этот атрибут, как инструмент для проверки типа загружаемого файла. Загруженные файлы должны проверятся на сервере. Пример »

Примечание: атрибут accept не поддерживается в IE9 и более ранних версиях.

Alt: Предоставляет альтернативный текст для пользователя, если он по каким-либо причинам не может просматривать изображения. Атрибут alt может использоваться только совместно с атрибутом type="image". autocomplete: Определяет, будет ли включено автозаполнение для поля ввода данных:

on - браузер автоматически показывает значения вводимые ранее пользователем (значение по умолчанию).
off - пользователь должен сам вводить значения для поля при каждом использовании формы. Ранее вводимые значения показываться не будут.

Примечание: атрибут autocomplete работает со следующими значениями атрибута type элемента : text, search, url, tel, email, password, datepickers, range и color.

Autofocus: Указывает браузеру, что элемент должен получить фокус после загрузки страницы. Значения для логического атрибута autofocus можно задавать следующими способами:

Примечание: атрибут autofocus не поддерживается в IE9 и более ранних версиях.

Checked: Указывает, что данный элемент будет выбран по умолчанию при загрузке страницы. Работает только с атрибутом type="checkbox" или type="radio". Значения для логического атрибута checked можно задавать следующими способами: Пример » disabled: Указывает, что элемент должен быть выключен (выключенный элемент является неактивным). Значения для логического атрибута disabled можно задавать следующими способами: Пример »

Примечание: атрибут disabled не работает с .

Form: Определяет форму с которой связан элемент . В качестве значения атрибута выступает идентификатор элемента . Этот атрибут позволяет размещать элемент в произвольном месте документа, а не только в качестве потомка элемента . Элемент может быть связан только с одной формой.

Если атрибут form не указан, то элемент должен быть потомком элемента .

Примечание: атрибут form не поддерживается в IE.

Formaction: Указывает URL-адрес файла, который будет обрабатывать данные ввода, при отправке формы. Атрибут formaction используется только с type="submit" или type="image", и переопределяет атрибут action элемента .

Примечание: атрибут formaction не поддерживается в IE9 и более ранних версиях.

Formenctype: Определяет способ кодирования данных формы при отправке на сервер. Может использоваться только совместно с атрибутом method="post" элемента . Возможные значения:

application/x-www-form-urlencoded - значение по умолчанию: все символы кодируются перед отправкой (пробелы преобразуются в символ "+ ", а специальные символы в значения ASCII HEX).
multipart/form-data - символы не кодируются. Используется для элементов , у которых в атрибуте type установлено значение "file ".
text/plain - пробелы преобразуются в символ "+", но не кодирует в шестнадцатеричные значения спецсимволы, такие как апострофы.

Атрибут formenctype используется только совместно с type="submit" или type="image", и переопределяет атрибут enctype элемента .

Примечание: атрибут formenctype не поддерживается в IE9 и более ранних версиях.

Formmethod: Определяет HTTP метод для отправки данных на указанный URL (для type="submit" и type="image"):

get - данные формы добавляются в конце URL-адреса: URL-адрес?имя=значение?имя=значение (значение по умолчанию).
post - отправляет данные формы, как HTTP после транзакции.

Атрибут formmethod может использоваться только совместно с type="submit" или type="image", и переопределяет атрибут method элемента .

Примечание: атрибут formmethod не поддерживается в IE9 и более ранних версиях.

Formnovalidate: Указывает, что данные введенные в поле ввода не будут проверяться перед отправкой. Возможные значения логического атрибута novalidate:

Примечание: атрибут formnovalidate не поддерживается в IE9 и более ранних версиях, и в Safari.

Formtarget: Определяет имя фрейма или ключевое слово, которое указывает место для отображения ответа, полученного после отправки формы:

_blank - открывает документ в новом окне или вкладке.
_self - открывает документ в той же директории, где располагается ссылка (значение по умолчанию).
_parent - открывает документ в родительском фрейме.
_top - открывает документ во всю ширину окна.
имя_фрейма - открывает документ в iframe, имя которого было указано в качестве значения.

Атрибут formtarget может использоваться только совместно с type="submit" или type="image", и переопределяет атрибут target элемента .

Примечание: атрибут formtarget не поддерживается в IE9 и более ранних версиях.

Height: Определяет высоту элемента в пикселях, используется только с (пример: height="100"). list: Устанавливает взаимосвязь между элементом и , позволяя для поля ввода указать список предварительно определенных вариантов. В качестве значения для атрибута выступает идентификатор элемента . Пример »

Примечание: атрибут list не поддерживается в IE9 и более ранних версиях, и в Safari.

Max: Указывает максимальное значение для ввода числа или даты. Можно использовать атрибут max совместно с атрибутом min для создания диапазона допустимых значений.

число - указывает максимально допустимое значение.
дата - указывает максимальную дату, разрешенную для ввода.

Атрибуты min и max работают со следующими значениями атрибута type: number, range, date, datetime, datetime-local, month, time и week.

Примечание: атрибут max не поддерживается в IE9 и более ранних версиях, и в Firefox.

Maxlength: Определяет максимальное количество символов, которое можно будет ввести в поле ввода. Этот атрибут можно использовать для ограничения количества символов, которое разрешается пользователю ввести в данное поле. Например при запросе года можно ограничить количество символов, установив значение атрибута maxlength равным 4. Пример » min: Определяет минимальное значение для ввода числа или даты.

число - указывает минимально допустимое значение.
дата - указывает минимальную дату, разрешенную для ввода.

Введите дату до 1980-01-01:
Введите дату после 2000-01-01:
Введите число (от 1 до 5):

Примечание: атрибут min не поддерживается в IE9 и более ранних версиях, и в Firefox.

Multiple: Указывает, что пользователь может ввести более одного значения. Атрибут multiple работает только с type="email" и type="file". Возможные значения логического атрибута multiple: Пример »

Примечание: атрибут multiple не поддерживается в IE9 и более ранних версиях.

Name: Атрибут name определяет имя элемента, оно отправляется на сервер вместе с введенными в поле данными. Имя может использоваться в JavaScript для ссылки на элемент или для идентификации переданных данных на сервере (например, при обработке данных на сервере, имя элемента позволяет определить, что было введено в качестве имени пользователя, а что - в качестве пароля). pattern: Указывает регулярное выражение, которое определяет синтаксис данных, ввод которых должен быть разрешен в поле ввода. Шаблон регулярного выражения должен соответствовать введенному значению целиком. Для описания работы шаблона можно воспользоваться глобальным атрибутом title. Атрибут pattern работает со следующими значениями атрибута type: text, search, url, tel, email и password.

Примечание: атрибут pattern не поддерживается в IE9 и более ранних версиях, и в Safari.

Placeholder: Определяет короткую подсказку, которая описывает ожидаемое значение для поля ввода (пример: образец значения или краткое описание ожидаемого формата). Подсказка отображается в поле ввода, когда оно пустое и исчезает, когда пользователь начинает вводить данные или когда поле получает фокус (разница в работе атрибута зависит от используемого браузера), если поле теряет фокус и при этом данные в поле не были введены, то в поле ввода вновь отобразится подсказка.

Атрибут placeholder работает со следующими значениями атрибута type: text, search, url, tel, email и password. Пример »

Примечание: атрибут placeholder не поддерживается в IE9 и более ранних версиях.

Readonly: Указывает, что поле ввода может быть использовано только для чтения и не может быть изменено (однако, текст можно выделить и скопировать). Возможные значения логического атрибута readonly: Пример » required: Указывает, что поле ввода необходимо заполнить перед отправкой формы. Если пользователь попытается отправить форму, не введя в поле никакого значения, то на экране отобразится предупреждающее сообщение. Это сообщение будет отличаться по содержанию и стилизации в зависимости от браузера и типа поля ввода.

Атрибут required работает со следующими значениями атрибута type: text, search, url, tel, email, password, date pickers, number, checkbox, radio и file. Возможные значения логического атрибута required:

Примечание: атрибут required не поддерживается в IE9 и более ранних версиях, и в Safari.

Size: Указывает ширину поля ввода (в качестве единицы измерения выступает количество видимых символов). Так, например, значение 3 создает поле ввода текста, ширина которого достаточна для отображение трех введенных символов (хотя пользователь при желании может ввести и большее количество). Атрибут size работает со следующими значениями атрибута type: text, search, tel, url, email и password. Для указания максимального количества вводимых знаков, воспользуйтесь атрибутом maxlength. Пример » src: Указывает путь к графическому файлу для поля с изображением. Атрибут src является обязательным для элементов с type="image" и может использоваться только с ними. step: Определяет интервал чисел для элемента . Пример: если step="3", то возможные значения чисел могут быть: -3, 0, 3, 6 и тд. Атрибут step может использоваться совместно с атрибутами max и min, для создания диапазона допустимых значений.

Примечание: атрибут step не поддерживается в IE9 и более ранних версиях, и в Firefox.

Type: Указывает, какой тип элемента управления будет отображен. По умолчанию браузеры используют , если не указано другое или неизвестное значение атрибута type. Таким образом, браузеры, не поддерживающие новые значения, просто заменят их значением по умолчанию и отобразят обычное текстовое поле ввода.

button - определяет активную кнопку (главным образом используется с JavaScript для активации скрипта).
checkbox - определяет элементы управления флажки, которые могут быть либо установлены, либо сняты. Можно установить сразу несколько флажков или не устанавливать ни один из них. Это отличает флажки от радио-кнопок (type="radio").
color - генерирует палитру цветов, давая возможность пользователям выбирать значения цветов в шестнадцатеричном формате.
date - позволяет получить доступ к встроенному в браузер виджету выбора даты.
datetime - определяет элемент управления датой и временем (год, месяц, день, час, минута, секунда и доли секунды, основанный на часовом поясе UTC).
datetime-local - определяет элемент управления датой и временем (год, месяц, день, час, минуты, секунды и доли секунды (без часового пояса)).
email - определяет поле для адреса электронной почты.
file - определяет элемент управления с кнопкой "Обзор", для выбора и загрузки файлов.
hidden - определяет скрытые поля ввода.
image - определяет изображение, как кнопку для отправки.
month - позволяет выбрать один месяц, после чего обеспечит ввод данных в виде года и месяца (например: 2014-05).
number - определяет поле для ввода чисел.
password - определяет поле для ввода пароля (замаскированные символы).
radio - создает радио-кнопки, которые являются взаимоисключающими, если выбрать одну радио-кнопку, то все остальные становятся неактивными.
range - создает элемент управления ползунок, диапазон ползунка по умолчанию - от 0 до 100. Для изменения диапазона используются атрибуты min и max с желаемыми значениями. Обратите внимание, что данный элемент управления не отображает текущее значение.
reset - определяет кнопку сброс (сбрасывает все поля формы в значения по умолчанию).
search - определяет текстовое поле для ввода строки поиска.
submit - определяет кнопку "Отправить".
tel - определяет поле для ввода телефонного номера.
text - определяет однострочное текстовое поле (ширина по умолчанию составляет 20 символов).
time - допускает ввод значений в 24-часовом формате, например: 12:34. В поддерживающих браузерах элемент управления отображается как числовое поле ввода со значением, изменяемым с помощью мыши, и допускает ввод только значений времени.
url - определяет поле для ввода URL-адреса.
week - позволяет выбрать одну неделю, после чего обеспечит ввод данных в формате года и недели (например: 2014-W15).

Пример » value: Указывает значение элемента , и используется по-разному для разных типов ввода:

Для "button", "reset", и "submit" - определяет текст на кнопке
Для "text", "password", "hidden" - определяет начальное (по умолчанию) значение поля ввода
Для "checkbox", "radio", "image" - определяет значение, связанное с вводом (значение, которое передается при отправке)

Атрибут value не может использоваться с type="file", и обязательно должен присутствовать при type="checkbox" и type="radio". Пример » width: Определяет ширину элемента в пикселях, используется только с (пример: width="100").

Тег так же поддерживает Глобальные атрибуты и События

Стиль по умолчанию

Пример

Тег - элемент языка html, позволяющий создавать различные части формы, такие как флажки, переключатели, поля ввода. Элемент не имеет конечного тега, так как все параметры задаются при помощи атрибутов.

Вид элемента определяет атрибут type :

type="text" - создание поля ввода, в котором можно автоматически разместить произвольный текст, используя атрибут value ;

type="password" - создание поля для ввода пароля, причем введенная информация отображается звездочками;

type="checkbox" - создание флажка;

type="radio" - определение одного переключателя. Для создания группы переключателей необходимо использовать несколько элементов .

type="button" - создание кнопки произвольного назначения;

type="submit" - создание кнопки, щелчок на которой подтверждает ввод информации в форму. Атрибут value используется для определения надписи на кнопке;

type="reset" - тоже кнопка, но для отмены ввода данных в форму;

type="image" - создание кнопки с рисунком. Для указания графического файла используется атрибут src . Атрибут align предназначен для позиционирования кнопки с рисунком. Значения атрибута уже неоднократно упоминались: bottom , left , middle , right , top .

type="file" - средство выбора файла для присоединения к форме. Пользователю предлагается записать имя файла в поле ввода. Кроме того, браузер автоматически создает рядом с полем ввода кнопку Обзор, которая позволяет запустить стандартный (для операционной системы) диалог выбора файлов;

type="hidden" - скрытый от пользователя элемент. Такие элементы используются для того, чтобы включить в набор данных формы некую фиксированную информацию. По сути, это определение имени переменной и ее значения.

Остальные атрибуты необходимы для определения свойств элемента. Многие из них являются обязательными, так как обеспечивают обработку данных формы на стороне сервера.

Пример написания:

Атрибуты тега

accept ....................Устанавливает фильтр на типы файлов, которые вы можете отправить через поле загрузки файлов.

accesskey . ...............Переход к элементу с помощью комбинации клавиш.

align .......................Определяет выравнивание изображения.

alt . ........................Альтернативный текст для кнопки с изображением.

autocomplete .........Включает или отключает автозаполнение.

border . ..................Толщина рамки вокруг изображения.

checked ................Предварительно активированный переключатель или флажок.

disabled . ...............Блокирует доступ и изменение элемента.

form ....................Связывает поле с формой по её идентификатору.

formaction ............Определяет адрес обработчика формы.

formenctype .........Устанавливает способ кодирования данных формы при их отправке на сервер.

formmethod .........Сообщает браузеру каким методом следует передавать данные формы на сервер.

formnovalidate . .....Отменяет встроенную проверку данных на корректность.

formtarget . ..........Определяет окно или фрейм в которое будет загружаться результат, возвращаемый обработчиком формы.

list . .....................Указывает на список вариантов, которые можно выбирать при вводе текста.

max ....................Верхнее значение для ввода числа или даты.

maxlength . ..........Максимальное количество символов разрешенных в тексте.

min ....................Нижнее значение для ввода числа или даты.

multiple ..............Позволяет загрузить несколько файлов одновременно.

name .. ..............Имя поля, предназначено для того, чтобы обработчик формы мог его идентифицировать.

pattern . .............Устанавливает шаблон ввода.

placeholder .........Выводит подсказывающий текст.

readonly ............Устанавливает, что поле не может изменяться пользователем.

required ............Обязательное для заполнения поле.

size . .................Ширина текстового поля.

src ...................Адрес графического файла для поля с изображением.

step ................Шаг приращения для числовых полей.

tabindex ...........Определяет порядок перехода между элементами с помощью клавиши Tab.

type . ...............Сообщает браузеру, к какому типу относится элемент формы.

value ...............Значение элемента.

Закрывающий тег не требуется.

Тег (от англ. input - вход) является одним из разносторонних элементов формы и позволяет создавать разные части интерфейса и обеспечивать взаимодействие с пользователем.

Главным образом предназначен для создания текстовых полей, различных кнопок, переключателей и флажков.

Основной атрибут , определяющий вид элемента - type . Он позволяет задавать следующие элементы формы: текстовое поле (text), поле с паролем (password), переключатель (radio), флажок (checkbox), скрытое поле (hidden), кнопка (button), кнопка для отправки формы (submit), кнопка для очистки формы (reset), поле для отправки файла (file), кнопка с изображением (image) и др. Для каждого элемента существует свой список атрибутов, которые определяют его вид и характеристики. Кроме того, в HTML5 добавлено ещё более десятка новых атрибутов.

Синтаксис

Закрывающий тег не требуется.

WAI ARIA

Нет значения role по-умолчанию.

Допустимые значения role:

button
checkbox
combobox
link
menuitem
menuitemcheckbox
menuitemradio
option
radio
searchbox
slider
spinbutton
switch
textbox

Атрибуты

accept - Устанавливает фильтр на типы файлов, которые вы можете отправить через поле загрузки файлов.
alt - Альтернативный текст для кнопки с изображением.
autocomplete - Включает или отключает автозаполнение.
autofocus - Устанавливает фокус в поле формы.
checked - Предварительно активированный переключатель или флажок.
dirname - Параметр, который передаёт на сервер направление текста.
disabled - Блокирует доступ и изменение элемента.
form - Связывает поле с формой по её идентификатору.
formaction - Определяет адрес обработчика формы.
formenctype - Устанавливает способ кодирования данных формы при их отправке на сервер.
formmethod - Сообщает браузеру каким методом следует передавать данные формы на сервер.
formnovalidate - Отменяет встроенную проверку данных на корректность.
formtarget - Определяет окно или фрейм в которое будет загружаться результат, возвращаемый обработчиком формы.
list - Указывает на список вариантов, которые можно выбирать при вводе текста.
max - Верхнее значение для ввода числа или даты.
maxlength - Максимальное количество символов разрешённых в тексте.
min - Нижнее значение для ввода числа или даты.
minlength - Минимальное количество символов разрешённых в тексте.
multiple - Позволяет загрузить несколько файлов одновременно.
name - Имя поля, предназначено для того, чтобы обработчик формы мог его идентифицировать.
pattern - Устанавливает шаблон ввода.
placeholder - Выводит подсказывающий текст.
readonly - Устанавливает, что поле не может изменяться пользователем.
required - Обязательное для заполнения поле.
size - Ширина текстового поля.
src - Адрес графического файла для поля с изображением.
step - Шаг приращения для числовых полей.
type - Сообщает браузеру, к какому типу относится элемент формы.
value - Значение элемента.

accept

Устанавливает фильтр на типы файлов, которые вы можете отправить через поле загрузки файлов. Тип файла указывается как MIME-тип, при нескольких значениях они перечисляются через запятую. Если файл не подходит под установленный фильтр, он не показывается в окне выбора файлов.

Применяется к полю для отправки файла ().

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

Значение по умолчанию

alt

Атрибут alt устанавливает альтернативный текст для поля с изображением. Такой текст позволяет получить текстовую информацию о рисунке при отключенной в браузере загрузке изображений, а также предназначен для поисковых систем.

Синтаксис

Значения

Любая подходящая текстовая строка.

Значение по умолчанию

autocomplete

Этот атрибут помогает заполнять поля форм текстом, который был введён в них ранее. Значения сохраняет и подставляет браузер, при этом автозаполнение по соображениям безопасности может отключаться пользователем в настройках браузера и не может в таком случае управляться атрибутом autocomplete .

При вводе первых букв текста выводится список сохранённых ранее значений, из которого можно выбрать необходимое.

Автозаполнение конкретного поля формы привязывается к его атрибуту name и при смене значения теряется.

Синтаксис

Значения

on - Включает автозаполнение текста.
off - Отключает автозаполнение. Это значение обычно используется для отмены сохранения в браузере важных данных (паролей, номеров банковских карт), а также редко вводимых или уникальных данных (капча).

Значение по умолчанию

Зависит от настроек браузера.

autofocus

Автоматически устанавливает фокус в поле формы. В таком поле можно сразу набирать текст без явного щелчка по нему курсором мыши.

Синтаксис

Значения

Значение по умолчанию

По умолчанию атрибут autofocus не установлен.

checked

Этот атрибут определяет, помечен ли заранее такой элемент формы, как флажок или переключатель. В случае использования переключателей (radiobutton) может быть отмечен только один элемент группы, для флажков (checkbox) допустимо пометить хоть все элементы.

Синтаксис

Значения

Значение по умолчанию

dirname

При наличии атрибута dirname на сервер отправляется пара имя/значение, где имя задаётся атрибутом dirname , а значение подставляется браузером. Для текста, идущего слева направо, значение будет ltr , а для текста справа налево (иврита, к примеру) значение будет rtl .

Синтаксис

Значения

Произвольная текстовая строка, которая служит именем параметра. Чтобы показать, что этот параметр указывает направление текста, обычно в конце строки добавляют.dir .

Значение по умолчанию

disabled

Блокирует доступ и изменение поля формы. Оно в таком случае отображается серым и недоступным для активации пользователем. Кроме того, такое поле не может получить фокус путем нажатия на клавишу Tab, мышью или другим способом. Тем не менее, такое состояние поля можно менять с помощью скриптов. Заблокированное в поле значение не передаётся на сервер.

Синтаксис

Значения

Значение по умолчанию

По умолчанию этот атрибут выключен.

form

Связывает поле с формой по её идентификатору. Такая связь необходима в случае, когда поле располагается за пределами

Значения

Идентификатор формы (значение атрибута id элемента

Значение по умолчанию

formaction

Определяет адрес обработчика формы - это программа, которая получает данные формы и производит с ними желаемые действия. Атрибут formaction по своему действию аналогичен атрибуту action элемента .

Синтаксис

Значения

formenctype

Устанавливает способ кодирования данных формы при их отправке на сервер. Обычно явно указывается в случае, когда используется поле для отправки файла (input type="file"). Этот атрибут по своему действию аналогичен атрибуту enctype элемента , при совместном использовании formenctype и enctype последний игнорируется.

Синтаксис

Значения

application/x-www-form-urlencoded - Вместо пробелов ставится + , символы вроде русских букв кодируются их шестнадцатеричными значениями (например, %D0%9F%D0%B5%D1%82%D1%8F вместо Петя).
multipart/form-data - Данные не кодируются. Это значение применяется при отправке файлов.
text/plain - Пробелы заменяются знаком + , буквы и другие символы не кодируются.

Значение по умолчанию

application/x-www-form-urlencoded

formmethod

Атрибут сообщает браузеру, каким методом следует передавать данные формы на сервер.

Синтаксис

Значения

Различают два метода - GET и POST , которые задаются ключевыми словами get и post .

get - Этот метод предназначен для передачи данных формы непосредственно в адресной строке в виде пар « имя=значение », которые добавляются к адресу страницы после вопросительного знака и разделяются между собой амперсандом (символ &). Полный адрес к примеру будет http://site.ru/doc/?name=Vasya&password=pup . Объём данных в методе ограничен 4 Кб.
post - Посылает на сервер данные в запросе браузера, объём пересылаемых данных ограничен лишь настройками сервера.

Значение по умолчанию

formnovalidate

Отменяет встроенную проверку данных введённых пользователем в форме на корректность перед отправкой формы. Такая проверка делается браузером автоматически для полей , , а также при наличии атрибута pattern или required у элемента .

Синтаксис

Значения

Значение по умолчанию

По умолчанию этот атрибут выключен.

formtarget

Определяет имя фрейма, в которое будет загружаться результат, возвращаемый обработчиком формы в виде HTML-документа.

Синтаксис

Значения

В качестве значения используется имя фрейма, заданное атрибутом name . Если установлено несуществующее имя, то будет открыта новая вкладка. В качестве зарезервированных имен можно указывать следующие.

_blank - Загружает страницу в новую вкладку браузера.
_self - Загружает страницу в текущую вкладку.
_parent - Загружает страницу во фрейм-родитель; если фреймов нет, то это значение работает как _self .
_top - Отменяет все фреймы и загружает страницу в полном окне браузера; если фреймов нет, то это значение работает как _self .

Значение по умолчанию

list

Указывает на список вариантов, созданный с помощью элемента , которые можно выбирать при наборе текста. Изначально этот список скрыт и становится доступным при получении полем фокуса.

Синтаксис

Значения

Имя идентификатора элемента .

Значение по умолчанию

max

Устанавливает верхнее значение для ввода числа или даты в поле формы.

Синтаксис

Значения

Значение по умолчанию

maxlength

Устанавливает максимальное число символов, которое может быть введено пользователем в текстовом поле. Когда это количество достигается при наборе, дальнейший ввод становится невозможным.

Синтаксис

Значения

Значение по умолчанию

Ввод символов не ограничен.

min

Устанавливает нижнее значение для ввода числа или даты в поле формы.

Синтаксис

Значения

Целое положительное или отрицательное число (для type="number" , type="range").

Дата в формате ГГГГ-ММ-ДД (например: 2012-12-22) для type="date" .

Значение по умолчанию

minlength

Задаёт минимальное число символов, которое может быть введено пользователем в текстовом поле. Если число символов меньше указанного значения, то браузер выдаёт сообщение об ошибке и не отправляет форму.

Синтаксис

Значения

Любое целое положительное число.

Значение по умолчанию

multiple

Атрибут multiple позволяет указывать одновременно несколько файлов в поле для загрузки файлов, а также несколько адресов электронной почты. При использовании двух и более почтовых адресов они должны перечисляться через запятую.

Синтаксис

Значения

Значение по умолчанию

По умолчанию атрибут multiple выключен.

name

Определяет уникальное имя элемента формы. Как правило, это имя используется при отправке данных на сервер или для доступа к введённым данным поля через скрипты.

Синтаксис

Значения

В качестве имени используется набор символов, включая числа и буквы. JavaScript чувствителен к регистру, поэтому при обращении к элементу по имени соблюдайте ту же форму написания, что и в атрибуте name .

Значение по умолчанию

pattern

Указывает регулярное выражение, согласно которому требуется вводить и проверять данные в поле формы. Если присутствует атрибут pattern , то форма не будет отправляться, пока поле не будет заполнено правильно.

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

Can I Use input-pattern? Data on support for the input-pattern feature across the major browsers from caniuse.com.

Синтаксис

Значения

Некоторые типовые регулярные выражения перечислены в табл. 1.

Табл. 1. Регулярные выражения

Выражение	Описание
d	Одна цифра от 0 до 9.
D [^0-9]	Любой символ кроме цифры.
s	Пробел.
	Только заглавная латинская буква.
	Только латинская буква в любом регистре.
[А-Яа-яЁё]	Только русская буква в любом регистре.
	Любая буква русского и латинского алфавита.
{3}	Три цифры.
{6,}	Не менее шести латинских букв.
{,3}	Не более трёх цифр.
{5,10}	От пяти до десяти цифр.
^+$	Любое слово на латинице.
^[А-Яа-яЁёs]+$	Любое слово на русском включая пробелы.
^[ 0-9]+$	Любое число.
{6}	Почтовый индекс.
d+(,d{2})?	Число в формате 1,34 (разделитель запятая).
d+(.d{2})?	Число в формате 2.10 (разделитель точка).
d{1,3}.d{1,3}.d{1,3}.d{1,3}	IP-адрес

placeholder

Выводит текст внутри поля формы, который исчезает при получении фокуса или при наборе текста. Обычно отображается серым цветом.

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

Can I Use input-placeholder? Data on support for the input-placeholder feature across the major browsers from caniuse.com.

Синтаксис

Значения

Текстовая строка. Если внутри строки предполагается пробел, её необходимо брать в двойные или одинарные кавычки.

Значение по умолчанию

readonly

Когда к элементу добавляется атрибут readonly , текстовое поле не может изменяться пользователем, в том числе вводиться новый текст или модифицироваться существующий. Тем не менее, состояние и содержимое поля можно менять с помощью скриптов и данные отправляются на сервер.

Синтаксис

Значения

Значение по умолчанию

По умолчанию этот атрибут выключен.

required

Устанавливает поле формы обязательным для заполнения перед отправкой формы на сервер. Если обязательное поле пустое, браузер выведет сообщение об ошибке, а форма отправлена не будет. Вид и содержание сообщения зависит от браузера и меняться пользователем не может.

Синтаксис

Значения

Значение по умолчанию

По умолчанию атрибут required выключен.

size

Ширина текстового поля, которое определяется числом символов моноширинного шрифта. Иными словами, ширина задаётся количеством близстоящих букв одинаковой ширины по горизонтали. Если размер шрифта изменяется с помощью стилей, ширина также соответственно меняется.

Синтаксис

Значения

Любое целое положительное число.

Значение по умолчанию

src

Адрес графического файла, который будет отображаться на веб-странице в поле с изображением. Наиболее популярны файлы в формате PNG и JPEG.

Синтаксис

Значения

В качестве значения принимается полный или относительный путь к файлу.

Значение по умолчанию

step

Устанавливает шаг изменения числа для ползунков и полей ввода чисел.

Синтаксис

Значения

Любое целое или дробное число.

Значение по умолчанию

type

Сообщает браузеру, к какому типу относится элемент формы.

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

email , tel , url:

Can I Use input-email-tel-url? Data on support for the input-email-tel-url feature across the major browsers from caniuse.com.

Can I Use input-color? Data on support for the input-color feature across the major browsers from caniuse.com.

Can I Use input-range? Data on support for the input-range feature across the major browsers from caniuse.com.

Can I Use input-number? Data on support for the input-number feature across the major browsers from caniuse.com.

Can I Use input-search? Data on support for the input-search feature across the major browsers from caniuse.com.

date , time , datetime:

Can I Use input-datetime? Data on support for the input-datetime feature across the major browsers from caniuse.com.

Синтаксис

Значения

Значения type:

button - Кнопка.
checkbox - Флажки. Позволяют выбрать более одного варианта из предложенных.
file - Поле для ввода имени файла, который пересылается на сервер.
hidden - Скрытое поле. Оно никак не отображается на веб-странице.
image - Поле с изображением. При нажатии на рисунок данные формы отправляются на сервер.
password - Обычное текстовое поле, но отличается от него тем, что все символы показываются звездочками. Предназначено для того, чтобы никто не подглядел вводимый пароль.
radio - Переключатели. Используются, когда следует выбрать один вариант из нескольких предложенных.
reset - Кнопка для возвращения данных формы в первоначальное значение.
submit - Кнопка для отправки данных формы на сервер.
text - Текстовое поле. Предназначено для ввода символов с помощью клавиатуры.

В HTML5 добавлены новые значения:

color - Виджет для выбора цвета.
date - Поле для выбора календарной даты.
datetime - Указание даты и времени.
datetime-local - Указание местной даты и времени.
email - Для адресов электронной почты.
number - Ввод чисел.
range - Ползунок для выбора чисел в указанном диапазоне.
search - Поле для поиска.
tel - Для телефонных номеров.
time - Для времени.
url - Для веб-адресов.
month - Выбор месяца.
week - Выбор недели.

Значение по умолчанию

value

Определяет значение элемента формы, которое будет отправлено на сервер или получено с помощью клиентских скриптов. На сервер отправляется пара « имя=значение », где имя задаётся атрибутом name элемента , а значение - атрибутом value .

В зависимости от типа элемента атрибут value выступает в следующей роли:

для кнопок (input type="button | reset | submit") устанавливает текстовую надпись на них;
для текстовых полей (input type="password | text") указывает предварительно введённую строку. Пользователь может стирать текст и вводить свои символы, но при использовании в форме кнопки Reset пользовательский текст очищается и восстанавливается введённый в атрибуте value ;
для флажков и переключателей (input type="checkbox | radio") уникально определяет каждый элемент, с тем, чтобы клиентская или серверная программа могла однозначно установить, какой пункт выбрал пользователь.
для файлового поля (input type="file") не оказывает влияние.

Синтаксис

Значения

Любая текстовая строка.

Значение по умолчанию

Значения ARIA role

- role=button
- role=checkbox
- role=textbox
- role=button
- role=spinbutton
- role=radio
- role=slider
- role=button
- role=searchbox
- role=button
- role=textbox
- role=textbox
- role=combobox
- role=textbox

Параметры input. Описание параметров тега

Описание

Атрибуты

Стиль по умолчанию

Пример

Синтаксис

WAI ARIA

Атрибуты

accept

alt

autocomplete

autofocus

checked

dirname

disabled

form

formaction

formenctype

formmethod

formnovalidate

formtarget

list

max

maxlength

min

minlength

multiple

name

pattern

placeholder

readonly

required

size

src

step

type

value

Значения ARIA role

Лучшие статьи по теме