Перейти к основному содержимому

Атрибуты HTML для Input

В этой главе описываются различные атрибуты, которые можно использовать с элементом HTML <input>.


Атрибут value

Атрибут value задаёт начальное (значение по умолчанию) для поля ввода.

Пример

Текстовые поля, начинающиеся со значений по умолчанию.

Prompt
Форма, текстовые поля Имя и Фамилия которой имеют начальные (по умолчанию) значения "John" и "Doe", заданные атрибутом value.
Результат: полная HTML-страница

Атрибут readonly

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

Пример

Поле «имя», доступное только для чтения.

Prompt
Форма, в которой поле Имя доступно только для чтения (имеет атрибут readonly и значение "John"), поэтому его нельзя редактировать, но его значение всё же отправляется. Поле Фамилия остаётся редактируемым.
Результат: полная HTML-страница

Атрибут disabled

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

Пример

Отключённое поле «имя».

Prompt
Форма, в которой поле Имя отключено (имеет атрибут disabled и значение "John"), поэтому оно недоступно для использования, а его значение не отправляется. Поле Фамилия остаётся редактируемым.
Результат: полная HTML-страница

Атрибут size

Атрибут size задаёт видимую ширину поля ввода в символах. Значение по умолчанию — 20.

Примечание: size работает со следующими типами input: text, search, tel, url, email и password.

Пример

Широкое поле «имя» и узкое поле «PIN».

Prompt
Форма, использующая атрибут size для задания ширины полей: текстовое поле Имя с size="50" и текстовое поле PIN с size="4".
Результат: полная HTML-страница

Атрибут maxlength

Атрибут maxlength задаёт максимальное число символов, которое примет поле.

Примечание: Когда установлен maxlength, поле просто не примет больше символов, но не выдаст никакого сообщения. Чтобы предупредить пользователя, нужен JavaScript.

Пример

Поле «PIN», ограниченное четырьмя символами.

Prompt
Форма, использующая maxlength: поле Имя с size="50" и поле PIN с maxlength="4" и size="4", так что оно принимает максимум четыре символа.
Результат: полная HTML-страница

Атрибуты min и max

Атрибуты min и max задают наименьшее и наибольшее значение, которое примет поле.

Они работают со следующими типами input: number, range, date, datetime-local, month, time и week. Используйте их вместе, чтобы задать диапазон допустимых значений.

Пример

Поля даты с ограничениями min и max, а также числовое поле для количества от 1 до 5.

Prompt
Форма, использующая min и max: поле даты, которая должна быть до 1980-01-01 (max="1979-12-31"), поле даты, которая должна быть после 2000-01-01 (min="2000-01-02"), и числовое поле для количества от 1 до 5.
Результат: полная HTML-страница

Атрибут multiple

Атрибут multiple позволяет пользователю ввести более одного значения в поле. Работает с типами input email и file.

Пример

Поле для файла, принимающее более одного файла.

Prompt
Форма с полем загрузки файлов, которое принимает более одного файла с помощью атрибута multiple, с подписью «Выберите файлы:».
Результат: полная HTML-страница

Атрибут pattern

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

Работает со следующими типами input: text, date, search, url, tel, email и password.

Совет: Используйте глобальный атрибут title, чтобы описать шаблон, чтобы пользователь знал, чего от него ожидают.

Пример

Поле, принимающее только трёхбуквенный код страны.

Prompt
Форма с текстовым полем для кода страны, использующим pattern="[A-Za-z]{3}", так что принимаются только три буквы, с атрибутом title, описывающим шаблон.
Результат: полная HTML-страница

Атрибут placeholder

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

Работает со следующими типами input: text, search, url, number, tel, email и password.

Пример

Поле для телефона с подсказкой placeholder.

Prompt
Форма с полем телефона, показывающим подсказку placeholder "123-45-678" и использующим шаблон [0-9]{3}-[0-9]{2}-[0-9]{3}.
Результат: полная HTML-страница

Атрибут required

Атрибут required означает, что поле должно быть заполнено, прежде чем форму можно будет отправить.

Работает со следующими типами input: text, search, url, tel, email, password, средства выбора даты, number, checkbox, radio и file.

Пример

Обязательное поле имени пользователя.

Prompt
Форма с текстовым полем имени пользователя, имеющим атрибут required, поэтому форму нельзя отправить, пока оно не заполнено.
Результат: полная HTML-страница

Атрибут step

Атрибут step задаёт допустимые числовые интервалы для поля. Например, при step="3" допустимые числа — это -3, 0, 3, 6 и так далее.

Работает со следующими типами input: number, range, date, datetime-local, month, time и week. Можно использовать вместе с min и max, чтобы задать диапазон допустимых значений.

Примечание: Ограничения ввода не являются надёжными на 100%, и с помощью JavaScript можно добавить некорректные данные. Для безопасности сервер также должен проверять ввод.

Пример

Числовое поле, допускающее только интервалы по три.

Prompt
Форма с числовым полем с подписью «Очки:», использующим step="3", так что допустимы только числа с интервалом три.
Результат: полная HTML-страница

Атрибут autofocus

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

Пример

Поле «имя» получает фокус сразу после загрузки страницы.

Prompt
Форма, в которой поле Имя имеет атрибут autofocus, поэтому оно автоматически получает фокус при загрузке страницы. Также включает редактируемое поле Фамилия.
Результат: полная HTML-страница

Атрибуты height и width

Атрибуты height и width задают размер элемента <input type="image">.

Совет: Всегда задавайте оба атрибута. Когда размер известен, браузер резервирует место под изображение во время загрузки страницы, поэтому макет не «прыгает» по мере появления изображений.

Пример

Кнопка отправки в виде изображения с заданными высотой и шириной.

Prompt
Форма с текстовыми полями Имя и Фамилия и кнопкой отправки в виде изображения (input type="image", src "img_submit.gif", alt "Submit") с width="48" и height="48".
Результат: полная HTML-страница

Атрибут list

Атрибут list связывает input с элементом <datalist>, содержащим предопределённые варианты для него.

Пример

Input с предопределёнными значениями браузера в datalist.

Prompt
Форма с текстовым полем, атрибут list которого указывает на datalist с вариантами браузеров (Edge, Firefox, Chrome, Opera, Safari).
Результат: полная HTML-страница

Атрибут autocomplete

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

Работает с <form> и следующими типами input: text, search, url, tel, email, password, средства выбора даты, range и color.

Совет: В некоторых браузерах может потребоваться включить функцию автозаполнения в настройках, чтобы это работало.

Пример

Форма с включённым автозаполнением, но выключенным для поля email.

Prompt
Форма с action /action_page.php и autocomplete="on", содержащая поля Имя, Фамилия и Email, а также кнопку отправки. Поле Email переопределяет с autocomplete="off".
Результат: полная HTML-страница