Интерфейс HTMLInputElement

Все суперинтерфейсы:: Element, HTMLElement, Node

public interface HTMLInputElement extends HTMLElement

Элемент управления формы. Примечание. В зависимости от среды, в которой просматривается страница, свойство value может быть доступно только для чтения для типа ввода файла. Для типа ввода «password» возвращаемое фактическое значение может быть замаскировано для предотвращения несанкционированного использования. См. определение элемента INPUT в HTML 4.0.

См. также Спецификацию объектной модели документа (DOM) уровня 2.

Начиная с версии:: 1.4, DOM уровня 2

Краткое описание полей

Поля, объявленные в интерфейсе Node

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Модификатор и тип	Поле	Описание
`static final short`	`ATTRIBUTE_NODE`	Узел является `Attr`.
`static final short`	`CDATA_SECTION_NODE`	Узел является `CDATASection`.
`static final short`	`COMMENT_NODE`	Узел является `Comment`.
`static final short`	`DOCUMENT_FRAGMENT_NODE`	Узел является `DocumentFragment`.
`static final short`	`DOCUMENT_NODE`	Узел является `Document`.
`static final short`	`DOCUMENT_POSITION_CONTAINED_BY`	Узел содержится в опорном узле.
`static final short`	`DOCUMENT_POSITION_CONTAINS`	Узел содержит опорный узел.
`static final short`	`DOCUMENT_POSITION_DISCONNECTED`	Два узла не связаны.
`static final short`	`DOCUMENT_POSITION_FOLLOWING`	Узел следует за опорным узлом.
`static final short`	`DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC`	Определение того, какой узел является предшествующим, а какой последующим, зависит от реализации.
`static final short`	`DOCUMENT_POSITION_PRECEDING`	Второй узел предшествует опорному узлу.
`static final short`	`DOCUMENT_TYPE_NODE`	Узел является `DocumentType`.
`static final short`	`ELEMENT_NODE`	Узел является `Element`.
`static final short`	`ENTITY_NODE`	Узел является `Entity`.
`static final short`	`ENTITY_REFERENCE_NODE`	Узел является `EntityReference`.
`static final short`	`NOTATION_NODE`	Узел является `Notation`.
`static final short`	`PROCESSING_INSTRUCTION_NODE`	Узел является `ProcessingInstruction`.
`static final short`	`TEXT_NODE`	Узел является узлом `Text`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`blur()`	Убирает фокус клавиатуры с этого элемента.
`void`	`click()`	Имитирует щелчок мышью.
`void`	`focus()`	Передаёт этому элементу фокус клавиатуры.
`String`	`getAccept()`	Список типов содержимого, разделённых запятыми, которые сервер, обрабатывающий эту форму, сможет корректно обработать.
`String`	`getAccessKey()`	Клавиша доступа из одного символа для доступа к элементу управления формы.
`String`	`getAlign()`	Выравнивает этот объект (по вертикали или горизонтали) относительно окружающего текста.
`String`	`getAlt()`	Альтернативный текст для пользовательских агентов, не отображающих обычное содержимое этого элемента.
`boolean`	`getChecked()`	Если атрибут `type` элемента имеет значение «Radio» или «Checkbox», это свойство представляет текущее состояние элемента управления формы в интерактивном пользовательском агенте.
`boolean`	`getDefaultChecked()`	Если `type` имеет значение «Radio» или «Checkbox», это свойство представляет атрибут HTML checked элемента.
`String`	`getDefaultValue()`	Если атрибут `type` элемента имеет значение «Text», «File» или «Password», это свойство представляет атрибут HTML value элемента.
`boolean`	`getDisabled()`	Элемент управления недоступен в данном контексте.
`HTMLFormElement`	`getForm()`	Возвращает элемент `FORM`, содержащий этот элемент управления.
`int`	`getMaxLength()`	Максимальное количество символов для текстовых полей, если `type` имеет значение «Text» или «Password».
`String`	`getName()`	Имя элемента управления формы или объекта при отправке формы.
`boolean`	`getReadOnly()`	Этот элемент управления доступен только для чтения.
`String`	`getSize()`	Сведения о размере.
`String`	`getSrc()`	Если атрибут `type` имеет значение «Image», этот атрибут задаёт расположение изображения, используемого для оформления графической кнопки отправки формы.
`int`	`getTabIndex()`	Индекс, определяющий положение элемента в порядке перехода клавишей табуляции.
`String`	`getType()`	Тип создаваемого элемента управления.
`String`	`getUseMap()`	Использовать клиентскую карту изображения.
`String`	`getValue()`	Если атрибут `type` элемента имеет значение «Text», «File» или «Password», это свойство представляет текущее содержимое соответствующего элемента управления формы в интерактивном пользовательском агенте.
`void`	`select()`	Выбирает содержимое текстовой области.
`void`	`setAccept(String accept)`
`void`	`setAccessKey(String accessKey)`
`void`	`setAlign(String align)`
`void`	`setAlt(String alt)`
`void`	`setChecked(boolean checked)`
`void`	`setDefaultChecked(boolean defaultChecked)`
`void`	`setDefaultValue(String defaultValue)`
`void`	`setDisabled(boolean disabled)`
`void`	`setMaxLength(int maxLength)`
`void`	`setName(String name)`
`void`	`setReadOnly(boolean readOnly)`
`void`	`setSize(String size)`
`void`	`setSrc(String src)`
`void`	`setTabIndex(int tabIndex)`
`void`	`setUseMap(String useMap)`
`void`	`setValue(String value)`

Методы, объявленные в интерфейсе Element

getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS

Модификатор и тип	Метод	Описание
`String`	`getAttribute(String name)`	Получает значение атрибута по имени.
`Attr`	`getAttributeNode(String name)`	Получает узел атрибута по имени.
`Attr`	`getAttributeNodeNS(String namespaceURI, String localName)`	Получает узел `Attr` по локальному имени и URI пространства имён.
`String`	`getAttributeNS(String namespaceURI, String localName)`	Получает значение атрибута по локальному имени и URI пространства имён.
`NodeList`	`getElementsByTagName(String name)`	Возвращает `NodeList` всех дочерних элементов `Elements` с заданным именем тега в порядке следования в документе.
`NodeList`	`getElementsByTagNameNS(String namespaceURI, String localName)`	Возвращает `NodeList` всех дочерних элементов `Elements` с заданным локальным именем и URI пространства имён в порядке следования в документе.
`TypeInfo`	`getSchemaTypeInfo()`	Информация о типе, связанная с этим элементом.
`String`	`getTagName()`	Имя элемента.
`boolean`	`hasAttribute(String name)`	Возвращает `true`, если атрибут с заданным именем указан для этого элемента или имеет значение по умолчанию, иное возвращает `false`.
`boolean`	`hasAttributeNS(String namespaceURI, String localName)`	Возвращает `true`, если атрибут с заданным локальным именем и URI пространства имён указан для этого элемента или имеет значение по умолчанию, иное возвращает `false`.
`void`	`removeAttribute(String name)`	Удаляет атрибут по имени.
`Attr`	`removeAttributeNode(Attr oldAttr)`	Удаляет указанный узел атрибута.
`void`	`removeAttributeNS(String namespaceURI, String localName)`	Удаляет атрибут по локальному имени и URI пространства имён.
`void`	`setAttribute(String name, String value)`	Добавляет новый атрибут.
`Attr`	`setAttributeNode(Attr newAttr)`	Добавляет новый узел атрибута.
`Attr`	`setAttributeNodeNS(Attr newAttr)`	Добавляет новый атрибут.
`void`	`setAttributeNS(String namespaceURI, String qualifiedName, String value)`	Добавляет новый атрибут.
`void`	`setIdAttribute(String name, boolean isId)`	Если параметр `isId` имеет значение `true`, этот метод объявляет указанный атрибут идентификатором, определённым пользователем.
`void`	`setIdAttributeNode(Attr idAttr, boolean isId)`	Если параметр `isId` имеет значение `true`, этот метод объявляет указанный атрибут идентификатором, определённым пользователем.
`void`	`setIdAttributeNS(String namespaceURI, String localName, boolean isId)`	Если параметр `isId` имеет значение `true`, этот метод объявляет указанный атрибут идентификатором, определённым пользователем.

Методы, объявленные в интерфейсе HTMLElement

getClassName, getDir, getId, getLang, getTitle, setClassName, setDir, setId, setLang, setTitle

Модификатор и тип	Метод	Описание
`String`	`getClassName()`	Атрибут class элемента.
`String`	`getDir()`	Задаёт базовое направление текста с нейтральным направлением и направленность таблиц.
`String`	`getId()`	Идентификатор элемента.
`String`	`getLang()`	Код языка, определённый в RFC 1766.
`String`	`getTitle()`	Подсказка-заголовок элемента.
`void`	`setClassName(String className)`
`void`	`setDir(String dir)`
`void`	`setId(String id)`
`void`	`setLang(String lang)`
`void`	`setTitle(String title)`

Методы, объявленные в интерфейсе Node

appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

Модификатор и тип	Метод	Описание
`Node`	`appendChild(Node newChild)`	Добавляет узел `newChild` в конец списка дочерних узлов этого узла.
`Node`	`cloneNode(boolean deep)`	Возвращает копию этого узла, то есть служит универсальным конструктором копирования узлов.
`short`	`compareDocumentPosition(Node other)`	Сравнивает опорный узел, то есть узел, для которого вызывается этот метод, с другим узлом, переданным в качестве параметра, по их положению в документе и в соответствии с порядком следования в документе.
`NamedNodeMap`	`getAttributes()`	`NamedNodeMap`, содержащий атрибуты этого узла (если это `Element`), или `null` в противном случае.
`String`	`getBaseURI()`	Абсолютный базовый URI этого узла или `null`, если реализации не удалось получить абсолютный URI.
`NodeList`	`getChildNodes()`	`NodeList`, содержащий все дочерние узлы этого узла.
`Object`	`getFeature(String feature, String version)`	Этот метод возвращает специализированный объект, реализующий специализированные API указанной функции и версии, как указано в .
`Node`	`getFirstChild()`	Первый дочерний узел этого узла.
`Node`	`getLastChild()`	Последний дочерний узел этого узла.
`String`	`getLocalName()`	Возвращает локальную часть квалифицированного имени этого узла.
`String`	`getNamespaceURI()`	URI пространства имён этого узла или `null`, если он не указан (см. ).
`Node`	`getNextSibling()`	Узел, непосредственно следующий за этим узлом.
`String`	`getNodeName()`	Имя этого узла, зависящее от его типа; см. таблицу выше.
`short`	`getNodeType()`	Код, представляющий тип базового объекта, как определено выше.
`String`	`getNodeValue()`	Значение этого узла, зависящее от его типа; см. таблицу выше.
`Document`	`getOwnerDocument()`	Объект `Document`, связанный с этим узлом.
`Node`	`getParentNode()`	Родительский узел этого узла.
`String`	`getPrefix()`	Префикс пространства имён этого узла или `null`, если он не указан.
`Node`	`getPreviousSibling()`	Узел, непосредственно предшествующий этому узлу.
`String`	`getTextContent()`	Этот атрибут возвращает текстовое содержимое данного узла и его потомков.
`Object`	`getUserData(String key)`	Получает объект, связанный с ключом в этом узле.
`boolean`	`hasAttributes()`	Возвращает, есть ли у этого узла атрибуты (если это элемент).
`boolean`	`hasChildNodes()`	Возвращает, есть ли у этого узла дочерние узлы.
`Node`	`insertBefore(Node newChild, Node refChild)`	Вставляет узел `newChild` перед существующим дочерним узлом `refChild`.
`boolean`	`isDefaultNamespace(String namespaceURI)`	Этот метод проверяет, является ли указанный `namespaceURI` пространством имён по умолчанию.
`boolean`	`isEqualNode(Node arg)`	Проверяет, равны ли два узла.
`boolean`	`isSameNode(Node other)`	Возвращает, является ли этот узел тем же узлом, что и заданный.
`boolean`	`isSupported(String feature, String version)`	Проверяет, реализует ли реализация DOM определённую функцию и поддерживается ли эта функция данным узлом, как указано в .
`String`	`lookupNamespaceURI(String prefix)`	Находит URI пространства имён, связанный с заданным префиксом, начиная с этого узла.
`String`	`lookupPrefix(String namespaceURI)`	Находит префикс, связанный с заданным URI пространства имён, начиная с этого узла.
`void`	`normalize()`	Приводит все узлы `Text` на всей глубине поддерева под этим `Node`, включая узлы атрибутов, к «нормальной» форме, в которой только структурные элементы (например, элементы, комментарии, инструкции обработки, секции CDATA и ссылки на сущности) отделяют узлы `Text`; то есть смежные узлы `Text` и пустые узлы `Text` отсутствуют.
`Node`	`removeChild(Node oldChild)`	Удаляет дочерний узел, указанный параметром `oldChild`, из списка дочерних узлов и возвращает его.
`Node`	`replaceChild(Node newChild, Node oldChild)`	Заменяет дочерний узел `oldChild` узлом `newChild` в списке дочерних узлов и возвращает узел `oldChild`.
`void`	`setNodeValue(String nodeValue)`	Значение этого узла, зависящее от его типа; см. таблицу выше.
`void`	`setPrefix(String prefix)`	Префикс пространства имён этого узла или `null`, если он не указан.
`void`	`setTextContent(String textContent)`	Этот атрибут возвращает текстовое содержимое данного узла и его потомков.
`Object`	`setUserData(String key, Object data, UserDataHandler handler)`	Связывает объект с ключом в этом узле.

Подробное описание методов

getDefaultValue

String getDefaultValue()

Если атрибут type элемента имеет значение "Text", "File" или "Password", это значение атрибута HTML value элемента. Значение этого атрибута не изменяется, если содержимое соответствующего элемента управления формы в интерактивном пользовательском агенте изменяется. Однако изменение этого атрибута сбрасывает содержимое элемента управления формы. См. определение атрибута value в HTML 4.0.

setDefaultValue

void setDefaultValue(String defaultValue)

getDefaultChecked

boolean getDefaultChecked()

Если type имеет значение "Radio" или "Checkbox", это атрибут HTML checked элемента. Значение этого атрибута не изменяется, если состояние соответствующего элемента управления формы в интерактивном пользовательском агенте изменяется. Однако изменение этого атрибута сбрасывает состояние элемента управления формы. См. определение атрибута checked в HTML 4.0.

setDefaultChecked

void setDefaultChecked(boolean defaultChecked)

getForm

HTMLFormElement getForm()

Возвращает элемент FORM, содержащий этот элемент управления. Возвращает null, если этот элемент управления не находится в контексте формы.

getAccept

String getAccept()

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

setAccept

void setAccept(String accept)

getAccessKey

String getAccessKey()

Одиночный символ — клавиша доступа к элементу управления формы. См. определение атрибута accesskey в HTML 4.0.

setAccessKey

void setAccessKey(String accessKey)

getAlign

String getAlign()

Выравнивает этот объект (по вертикали или горизонтали) относительно окружающего текста. См. определение атрибута align в HTML 4.0. Этот атрибут устарел в HTML 4.0.

setAlign

void setAlign(String align)

getAlt

String getAlt()

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

setAlt

void setAlt(String alt)

getChecked

boolean getChecked()

Если атрибут type элемента имеет значение "Radio" или "Checkbox", это текущее состояние элемента управления формы в интерактивном пользовательском агенте. Изменение этого атрибута меняет состояние элемента управления формы, но не изменяет значение атрибута HTML value элемента.

setChecked

void setChecked(boolean checked)

getDisabled

boolean getDisabled()

Элемент управления недоступен в данном контексте. См. определение атрибута disabled в HTML 4.0.

setDisabled

void setDisabled(boolean disabled)

getMaxLength

int getMaxLength()

Максимальное количество символов для текстовых полей, если type имеет значение "Text" или "Password". См. определение атрибута maxlength в HTML 4.0.

setMaxLength

void setMaxLength(int maxLength)

getName

String getName()

Имя элемента управления формы или объекта при отправке вместе с формой. См. определение атрибута name в HTML 4.0.

setName

void setName(String name)

getReadOnly

boolean getReadOnly()

Этот элемент управления доступен только для чтения. Применимо только в том случае, если type имеет значение "Text" или "Password". См. определение атрибута readonly в HTML 4.0.

setReadOnly

void setReadOnly(boolean readOnly)

getSize

String getSize()

Информация о размере. Точное значение зависит от типа поля. См. определение атрибута size в HTML 4.0.

setSize

void setSize(String size)

getSrc

String getSrc()

Если атрибут type имеет значение "Image", этот атрибут указывает расположение изображения, которое будет использоваться для оформления графической кнопки отправки. См. определение атрибута src в HTML 4.0.

setSrc

void setSrc(String src)

getTabIndex

int getTabIndex()

Индекс, определяющий положение элемента в порядке перехода по табуляции. См. определение атрибута tabindex в HTML 4.0.

setTabIndex

void setTabIndex(int tabIndex)

getType

String getType()

Тип создаваемого элемента управления. См. определение атрибута type в HTML 4.0.

getUseMap

String getUseMap()

Использование клиентской карты изображений. См. определение атрибута usemap в HTML 4.0.

setUseMap

void setUseMap(String useMap)

getValue

String getValue()

Если атрибут type элемента имеет значение "Text", "File" или "Password", это текущее содержимое соответствующего элемента управления формы в интерактивном пользовательском агенте. Изменение этого атрибута меняет содержимое элемента управления формы, но не изменяет значение атрибута HTML value элемента. Если атрибут type элемента имеет значение "Button", "Hidden", "Submit", "Reset", "Image", "Checkbox" или "Radio", это атрибут HTML value элемента. См. определение атрибута value в HTML 4.0.

setValue

void setValue(String value)

blur

void blur()

Убирает клавиатурный фокус с этого элемента.

focus

void focus()

Устанавливает клавиатурный фокус на этот элемент.

select

void select()

Выбирает содержимое текстовой области. Для элементов INPUT, атрибут type которых имеет одно из следующих значений: "Text", "File" или "Password".

click

void click()

Имитирует щелчок мышью. Для элементов INPUT, атрибут type которых имеет одно из следующих значений: "Button", "Checkbox", "Radio", "Reset" или "Submit".

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.