HTMLInputElement

Интерфейс HTMLInputElement предоставляет специальные свойства и методы для управления параметрами, макетом и представлением элементов <input>.

Также наследует свойства от своего родительского интерфейса HTMLElement.

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

align Устаревшее

Строка, представляющая выравнивание элемента. Используйте CSS вместо этого.

defaultValue

Строка, представляющая значение по умолчанию, как изначально указано в HTML, создавшем этот объект.

dirName

Строка, представляющая направление элемента.

incremental Нестандартный

Булево значение, представляющее режим срабатывания события поиска, если true, срабатывает при каждом нажатии клавиши или при нажатии кнопки отмены; иначе срабатывает при нажатии Enter.

labels Только для чтения

Возвращает список элементов <label>, которые являются метками для этого элемента.

list Только для чтения

Возвращает элемент, на который указывает атрибут list. Свойство может быть null если элемент HTML не найден в том же дереве.

multiple

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

name

Строка, представляющая атрибут элемента name, содержащий имя, которое идентифицирует элемент при отправке формы.

popoverTargetAction

Получает и устанавливает действие, которое должно быть выполнено ("hide", "show", или "toggle" ) над элементом всплывающей подсказки, управляемым элементом <input> элемента type="button". Отражает значение атрибута HTML popovertargetaction.

popoverTargetElement

Получает и устанавливает элемент всплывающей подсказки для управления с помощью элемента <input> элемента type="button". JavaScript-эквивалент атрибута HTML popovertarget.

step

Строка, представляющая атрибут элемента step, который работает с атрибутами min и max для ограничения приращений, при которых можно установить числовое или временное значение. Может быть строкой any или положительным числом с плавающей запятой. Если не установлено any, элемент принимает только значения, кратные шагу, большие, чем минимальное.

type

Строка, представляющая атрибут элемента type, указывающая тип отображаемого элемента управления. Возможные значения см. в документации к атрибуту type.

useMap Устаревшее

Строка, представляющая клиентскую карту изображений.

value

Строка, представляющая текущее значение элемента управления. Если пользователь вводит значение, отличное от ожидаемого, это может вернуть пустую строку.

valueAsDate

Объект Date, представляющий значение элемента, интерпретированное как дата, или null если преобразование невозможно.

valueAsNumber

Число, представляющее значение элемента, интерпретированное как одно из следующих, в порядке приоритета: значение времени, число или NaN , если преобразование невозможно.

form Только для чтения

Возвращает ссылку на родительский элемент <form>.

formAction

Строка, представляющая атрибут элемента formaction, содержащий URL программы, которая обрабатывает информацию, отправленную элементом. Переопределяет атрибут action родительской формы.

formEnctype

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

formMethod

Строка, представляющая атрибут элемента formmethod, содержащий HTTP-метод, который браузер использует для отправки формы. Переопределяет атрибут method родительской формы.

formNoValidate

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

formTarget

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

disabled

Булево значение, представляющее атрибут элемента disabled, указывающий, что элемент управления недоступен для взаимодействия. Значения ввода не будут отправлены вместе с формой. См. также readonly.

required

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

validationMessage Только для чтения

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

validity Только для чтения

Возвращает текущее состояние валидности элемента.

willValidate Только для чтения

Возвращает, является ли элемент кандидатом для проверки ограничений. Он равен false если какие-либо условия препятствуют проверке ограничений, включая: его type является одним из hidden, reset или button, у него есть предковый элемент <datalist> или его свойство disabled равно true.

checked

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

defaultChecked

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

indeterminate

Булево значение, представляющее, находится ли флажок или радиокнопка в неопределенном состоянии. Для флажков это означает, что внешний вид флажка затемнен/серый, чтобы указать, что его состояние неопределено (не выбран, но и не невыбран). Не влияет на значение атрибута checked, и нажатие на флажок установит его значение в false.

alt

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

height

Строка, представляющая атрибут элемента height, определяющий высоту отображаемого изображения для кнопки.

src

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

width

Строка, представляющая атрибут элемента width, определяющий ширину отображаемого изображения для кнопки.

accept

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

capture

Строка, представляющая атрибут элемента capture, указывающая метод захвата медиа в элементах управления загрузкой файлов.

files

Объект FileList, представляющий файлы, выбранные для загрузки.

webkitdirectory

Булево значение, представляющее атрибут webkitdirectory. Если true, интерфейс выбора файловой системы принимает только каталоги, а не файлы.

webkitEntries Только для чтения

Описывает текущие выбранные файлы или каталоги.

autocomplete

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

max

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

maxLength

Число, представляющее атрибут элемента maxlength, содержащий максимальное количество символов (в кодовых точках Юникода), которые может иметь значение.

min

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

minLength

Число, представляющее атрибут элемента minlength, содержащий минимальное количество символов (в кодовых точках Юникода), которые может иметь значение.

pattern

Строка, представляющая атрибут элемента pattern, содержащая регулярное выражение, с которым проверяется значение элемента управления. Используйте атрибут title для описания шаблона и помощи пользователю. Этот атрибут применяется только тогда, когда значение атрибута type равно text, search, tel, url или email.

placeholder

Строка, представляющая атрибут элемента placeholder, содержащая подсказку для пользователя о том, что можно ввести в элемент управления. Текст подсказки не должен содержать символов перевода строки или возврата каретки. Этот атрибут применяется только когда значение атрибута type равно text, search, tel, url или email.

readOnly

Булево значение, представляющее атрибут элемента readonly, указывающее, что пользователь не может изменить значение элемента управления. Этот атрибут игнорируется, если атрибут type равен hidden, range, color, checkbox, radio, file, или типу кнопки.

selectionDirection

Строка, представляющая направление, в котором произошел выбор. Возможные значения: forward (выбор был выполнен в направлении "начало-конец" текущего языка), backward (противоположное направление) или none (направление неизвестно).

selectionEnd

Число, представляющее конечный индекс выбранного текста. При отсутствии выбора возвращает смещение символа, следующего сразу за текущей позицией курсора ввода текста.

selectionStart

Число, представляющее начальный индекс выбранного текста. При отсутствии выбора возвращает позицию курсора (каретки) ввода текста внутри элемента <input>.

size

Число, представляющее атрибут элемента size, содержащий визуальный размер элемента управления. Это значение в пикселях, за исключением случаев, когда значение type равно text или password, в этом случае это целое число символов. Применяется только когда type установлено в text, search, tel, url, email или password.

Также наследует методы от родительского интерфейса HTMLElement.

checkValidity()

Возвращает булево значение, которое равно false если элемент является кандидатом для проверки ограничений и не удовлетворяет своим ограничениям. В этом случае он также вызывает событие invalid в элементе. Возвращает true если элемент не является кандидатом для проверки ограничений или удовлетворяет своим ограничениям.

reportValidity()

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

select()

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

setCustomValidity()

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

setRangeText()

Заменяет диапазон текста в элементе управления вводом новым текстом.

setSelectionRange()

Выделяет диапазон текста в элементе управления вводом (но не фокусирует его).

showPicker()

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

stepDown()

Уменьшает значение value на (step * n), где n по умолчанию равно 1, если не указано иное.

stepUp()

Увеличивает значение value на (step * n), где n по умолчанию равно 1, если не указано иное.

Также наследует события от родительского интерфейса HTMLElement.

Подписывайтесь на эти события с помощью addEventListener() или назначив обработчик событий для свойства oneventname этого интерфейса:

cancel событие

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

invalid событие

Срабатывает, когда элемент не удовлетворяет своим ограничениям во время проверки ограничений.

search событие Нестандартное

Срабатывает, когда инициируется поиск в элементе <input> типа type="search".

select событие

Срабатывает, когда какой-либо текст был выбран.

selectionchange событие Экспериментальный

Срабатывает при изменении выделения текста в элементе <input>.

• HTML-элемент, реализующий этот интерфейс: <input>