— HTML: язык гипертекстовой разметки
элементов типа text
создают базовые однострочные текстовые поля.
Атрибут value
представляет собой строку, содержащую текущее значение текста, введенного в текстовое поле. Вы можете получить это, используя свойство HTMLInputElement
value
в JavaScript.
пусть theText = myTextInput.value;
Если для ввода не установлены ограничения проверки (дополнительные сведения см. в разделе Проверка), значение может быть пустой строкой ( ""
).
В дополнение к атрибутам, которые работают со всеми элементами
независимо от их типа, ввод текста поддерживает следующие атрибуты.
list
Значения атрибута list — это id
элемента
, расположенного в том же документе.
предоставляет список предопределенных значений, которые можно предложить пользователю для этого ввода. Любые значения в списке, которые несовместимы с тип
не входят в предлагаемые варианты. Предоставленные значения являются рекомендациями, а не требованиями: пользователи могут выбрать из этого предопределенного списка или указать другое значение.
maxlength
Максимальное количество символов (в единицах кода UTF-16), которое пользователь может ввести в текст ввода
. Это должно быть целочисленное значение от 0 или выше. Если maxlength
не указано или указано недопустимое значение, ввод text
не имеет максимальной длины. Это значение также должно быть больше или равно значению 9.0003 минимальная длина .
Ввод не пройдет проверку ограничения, если длина текстового значения поля превышает maxlength
длины кодовых единиц UTF-16. Проверка ограничения применяется только тогда, когда значение изменяется пользователем.
minlength
Минимальное количество символов (в единицах кода UTF-16), которое пользователь может ввести в текст ввода
. Это должно быть неотрицательное целочисленное значение, меньшее или равное значению, указанному в максимальная длина
. Если minlength
не указано или указано недопустимое значение, ввод text
не имеет минимальной длины.
Ввод не пройдет проверку ограничения, если длина текста, введенного в поле, меньше minlength Длина
единиц кода UTF-16. Проверка ограничения применяется только тогда, когда значение изменяется пользователем.
шаблон
Атрибут шаблон
, если он указан, является регулярным выражением, которое значение
должно совпадать, чтобы значение прошло проверку ограничения. Это должно быть допустимое регулярное выражение JavaScript, используемое типом RegExp
, и как описано в нашем руководстве по регулярным выражениям; флаг 'u'
указывается при компиляции регулярного выражения, чтобы шаблон обрабатывался как последовательность кодовых точек Unicode, а не как ASCII. Вокруг текста шаблона не должно указываться косая черта.
Если указанный шаблон не указан или недействителен, регулярное выражение не применяется и этот атрибут полностью игнорируется.
Примечание: Используйте атрибут title
, чтобы указать текст, который большинство браузеров будет отображать в качестве всплывающей подсказки, чтобы объяснить, какие требования должны соответствовать шаблону. Вы также должны включить другой пояснительный текст рядом.
Дополнительные сведения и пример см. в разделе «Указание шаблона».
заполнитель
Атрибут заполнитель
представляет собой строку, которая дает пользователю краткую подсказку о том, какая информация ожидается в поле. Это должно быть слово или короткая фраза, демонстрирующая ожидаемый тип данных, а не поясняющее сообщение. Текст не должен включать в себя возврат каретки или перевод строки.
Если содержимое элемента управления имеет одну направленность (LTR или RTL), но необходимо представить заполнитель в противоположном направлении, вы можете использовать символы форматирования двунаправленного алгоритма Unicode для переопределения направленности внутри заполнителя; Дополнительные сведения см. в разделе Как использовать элементы управления Unicode для двунаправленного текста.
Примечание: По возможности избегайте использования атрибута-заполнителя
. Это не так полезно с семантической точки зрения, как другие способы объяснения вашей формы, и может вызвать неожиданные технические проблемы с вашим контентом. См.
проблемы с доступностью для получения дополнительной информации.
только для чтения
Логический атрибут, который, если присутствует, означает, что это поле не может быть отредактировано пользователем. Однако его значение
по-прежнему может быть изменено кодом JavaScript, непосредственно устанавливающим свойство HTMLInputElement
value
.
Примечание: Поскольку поле только для чтения не может иметь значения, обязательно
не влияет на ввод с 9Также указан атрибут 0003 readonly .
size
Атрибут size
представляет собой числовое значение, указывающее, сколько символов должно быть в поле ввода. Значение должно быть числом больше нуля, а значение по умолчанию равно 20. Поскольку ширина символов различается, это может быть или не быть точным, и на это не следует полагаться; результирующий ввод может быть уже или шире, чем указанное количество символов, в зависимости от символов и шрифта ( 9Используемые настройки шрифта 0003 ).
Это означает, что , а не устанавливает ограничение на количество символов, которые пользователь может ввести в поле. Он лишь указывает приблизительно, сколько можно увидеть одновременно. Чтобы установить верхний предел длины входных данных, используйте атрибут maxlength
.
проверка орфографии
проверка орфографии
— это глобальный атрибут, который используется для указания, следует ли включать проверку орфографии для элемента. Его можно использовать на любом редактируемом контенте, но здесь мы рассмотрим особенности, связанные с использованием
на
элементах. Допустимые значения для проверка орфографии
:
-
ложь
Отключить проверку орфографии для этого элемента.
-
правда
Включить проверку орфографии для этого элемента.
-
""
(пустая строка) или нет значения Следуйте стандартному поведению элемента для проверки орфографии. Это может быть основано на родительском
настройка проверки правописания
или другие факторы.
В поле ввода может быть включена проверка орфографии, если для него не установлен атрибут readonly и он не отключен.
Значение, возвращаемое при чтении проверка орфографии
, может не отражать фактическое состояние проверки орфографии в элементе управления, если настройки пользовательского агента переопределяют настройку.
Следующие нестандартные атрибуты также доступны в некоторых браузерах. Как правило, вам следует избегать их использования, за исключением случаев, когда это бесполезно.
autocorrect
Расширение Safari, атрибут autocorrect
представляет собой строку, указывающую, активировать ли автоматическое исправление, пока пользователь редактирует это поле. Допустимые значения:
-
на
Включить автоматическое исправление опечаток, а также обработку текстовых подстановок, если таковые настроены.
-
от
Отключить автоматическое исправление и замену текста.
mozactionhint
Расширение Mozilla, которое дает подсказку о том, какое действие будет выполнено, если пользователь нажмет клавишу Enter или Return при редактировании поля.
Этот атрибут устарел: вместо него используйте глобальный атрибут enterkeyhint
.
элемента типа text
создают базовые однострочные вводы. Вы должны использовать их везде, где вы хотите, чтобы пользователь ввел однострочное значение, и нет более конкретного типа ввода, доступного для сбора этого значения (например, если это дата, URL-адрес, электронная почта или поисковый запрос, у нас есть лучшие варианты).
Базовый пример
<форма> <дел> <тип ввода="текст" имя="имя" />