Книга: JavaScript. Подробное руководство, 6-е издание

Input

Input

HTML-элемент <input> (Node, Element, FormControl)

Объект Input представляет HTML-тег <input>. Его внешний вид и поведение определяется атрибутом type: элемент Input может представлять, например, простое текстовое поле ввода, флажок, радиокнопку, простую кнопку или элемент выбора файла. Так как элемент <input> может представлять самые разные элементы форм, объект Input является одним из самых сложных. Краткий обзор HTML-форм и их элементов приводится в разделе 15.9. Обратите внимание, что некоторые из важных свойств объекта Input (такие как type, value, name и form) описываются в справочной статье FormControl.

Свойства

Помимо свойств, перечисленных ниже, объекты Input также поддерживают все свойства, определенные в объектах Element и FormControl. Свойства в этом списке, помеченные звездочкой, являются новыми, введенными спецификацией HTML5, и на момент написания этих строк они были реализованы не во всех броузерах.

string accept

Если свойство type имеет значение «file», это свойство содержит список МІМЕ-типов, разделенных запятыми, определяющих типы файлов, которые могут быть выбраны. Допустимыми являются также строки «audio/*», «video/*» и «image/*». Соответствует атрибуту accept.

string autocomplete

Значение true, если броузеру разрешено предварительно заполнять этот элемент Input значением, сохранившимся с предыдущего сеанса. Соответствует атрибуту autocomplete. См. также описание свойства autocomplete объекта Form.

boolean checked

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

boolean defaultChecked

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

string defaultValue

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

readonly File[] files

Для элементов, значением свойства type которых является строка «file», данное свойство ссылается на объект, подобный массиву, хранящий объект или объекты File, соответствующие файлам, выбранным пользователем.

string formAction*

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

string formEnctype*

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

string formMethod*

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

boolean formNoValidate*

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

string formTarget*

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

boolean indeterminate

Для флажков это свойство определяет, находится ли элемент в неопределенном состоянии (т. е. элемент ни отмечен, ни не отмечен). Это свойство не является отражением какого-либо HTML-атрибута: его можно установить только в сценариях на языке JavaScript.

readonly Element list*

Элемент <datalist>, содержащий элементы <option>, которые броузер может использовать в качестве значений для подсказки или автодополнения.

string max*

Максимальное допустимое значение для данного элемента Input.

long maxLength

Когда значением свойства type является строка «text» или «password», данное свойство определяет максимальное число символов, которые пользователь сможет ввести. Не путайте это свойство со свойством size. Соответствует атрибуту maxlength.

string min*

Минимальное допустимое значение для данного элемента Input.

boolean multiple*

Значение true, если элемент ввода должен принимать более одного значения указанного типа. Соответствует атрибуту multiple.

string pattern*

Текст регулярного выражения, которому должен соответствовать введенный текст, чтобы его можно было признать допустимым. Это свойство использует синтаксис регулярных выражений JavaScript (без начального и конечного символов слэша), но имейте в виду, что значением этого свойства является строка, а не объект RegExp. Отметьте также - чтобы введенный текст был признан допустимым, шаблону должен соответствовать текст целиком, а не только какая-то его часть. (Как если бы шаблон начинался с символа ~ и заканчивался символом $.) Это свойство соответствует атрибуту pattern.

string placeholder

Короткая текстовая строка, которая должна выводиться в элементе Input, как приглашение к вводу. Когда пользователь передаст элементу фокус ввода, текст, приглашения будет стерт и в элементе появится текстовый курсор. Это свойство соответствует атрибуту placeholder.

boolean readonly

Если имеет значение true, элемент будет недоступен для редактирования. Соответствует атрибуту readonly.

boolean required*

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

required.

readonly Option selectedOption*

Если свойство list определено и свойство multiple имеет значение false, данное свойство возвращает выбранный элемент Option из списка list, если таковой имеется.

unsigned long selectionEnd

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

unsigned long selectionStart

Возвращает или изменяет индекс первого символа в выделенном фрагменте в элементе <textarea>. См. также setSelectionRange().

unsigned long size

Для текстовых элементов ввода данное свойство определяет ширину элемента в символах. Соответствует атрибуту size. Не путайте со свойством maxLength.

string step*

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

Date valueAsDate*

Возвращает значение элемента (см. FormControl) в виде объекта Date.

double valueAsNumber*

Возвращает значение элемента (см. FormControl) в виде числа.

Методы

В дополнение к методам, перечисленным ниже, элементы Input реализуют также все методы объектов Element и FormControl. Методы, отмеченные звездочкой в этом списке, являются новыми, определяемыми спецификацией HTML5, которые на момент написания этих строк были реализованы не во всех броузерах.

void select()

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

void setSelectionRange(unsigned long start, unsigned long end)

Этот метод выделяет текст, отображаемый в элементе Input, начиная с символа в позиции start и до (не включая) символа в позиции end.

void stepDown([long n])*

Для элементов, поддерживающих свойство step, уменьшает текущее значение на n шагов.

void stepUp([long n])*

Для элементов, поддерживающих свойство step, увеличивает текущее значение на n шагов.

Оглавление книги