Интерфейс HTMLSelectElement

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

public interface HTMLSelectElement extends HTMLElement

Элемент select позволяет выбрать вариант. Доступ к содержащимся в нём вариантам можно получить непосредственно через элемент select в виде коллекции. См. описание элемента SELECT в HTML 4.0.

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

Начиная с версии:: 1.4, DOM Level 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`	`add(HTMLElement element, HTMLElement before)`	Добавляет новый элемент в коллекцию элементов `OPTION` этого элемента `SELECT` .
`void`	`blur()`	Снимает с этого элемента фокус клавиатуры.
`void`	`focus()`	Устанавливает фокус клавиатуры на этот элемент.
`boolean`	`getDisabled()`	Элемент управления недоступен в данном контексте.
`HTMLFormElement`	`getForm()`	Возвращает элемент `FORM`, содержащий этот элемент управления.
`int`	`getLength()`	Количество вариантов в этом элементе `SELECT` .
`boolean`	`getMultiple()`	Если значение равно true, в этом элементе `SELECT` можно выбрать несколько элементов `OPTION` .
`String`	`getName()`	Имя элемента управления формы или объекта при отправке формы.
`HTMLCollection`	`getOptions()`	Коллекция элементов `OPTION`, содержащихся в этом элементе.
`int`	`getSelectedIndex()`	Порядковый индекс выбранного варианта, начиная с 0.
`int`	`getSize()`	Количество видимых строк.
`int`	`getTabIndex()`	Индекс, определяющий положение элемента в порядке перехода клавишей Tab.
`String`	`getType()`	Тип этого элемента управления формы.
`String`	`getValue()`	Текущее значение элемента управления формы.
`void`	`remove(int index)`	Удаляет элемент из коллекции элементов `OPTION` этого элемента `SELECT` .
`void`	`setDisabled(boolean disabled)`
`void`	`setMultiple(boolean multiple)`
`void`	`setName(String name)`
`void`	`setSelectedIndex(int selectedIndex)`
`void`	`setSize(int size)`
`void`	`setTabIndex(int tabIndex)`
`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`, включая узлы атрибутов, к «нормальной» форме, в которой узлы `Text` разделяются только структурными элементами (например, элементами, комментариями, инструкциями обработки, секциями CDATA и ссылками на сущности), то есть отсутствуют соседние узлы `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)`	Связывает объект с ключом этого узла.

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

getType

String getType()

Тип этого элемента управления формы. Строка "select-multiple" возвращается, когда атрибут multiple имеет значение true, а строка "select-one" — когда false .

getSelectedIndex

int getSelectedIndex()

Порядковый индекс выбранного варианта, начиная с 0. Если ни один элемент не выбран, возвращается значение -1. Если выбрано несколько вариантов, возвращается индекс первого выбранного варианта.

setSelectedIndex

void setSelectedIndex(int selectedIndex)

getValue

String getValue()

Текущее значение элемента управления формы.

setValue

void setValue(String value)

getLength

int getLength()

Количество вариантов в этом элементе SELECT .

getForm

HTMLFormElement getForm()

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

getOptions

HTMLCollection getOptions()

Коллекция элементов OPTION, содержащихся в этом элементе.

getDisabled

boolean getDisabled()

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

setDisabled

void setDisabled(boolean disabled)

getMultiple

boolean getMultiple()

Если значение равно true, в этом элементе SELECT можно выбрать несколько элементов OPTION . См. описание атрибута multiple в HTML 4.0.

setMultiple

void setMultiple(boolean multiple)

getName

String getName()

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

setName

void setName(String name)

getSize

int getSize()

Количество видимых строк. См. описание атрибута size в HTML 4.0.

setSize

void setSize(int size)

getTabIndex

int getTabIndex()

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

setTabIndex

void setTabIndex(int tabIndex)

add

void add(HTMLElement element, HTMLElement before) throws DOMException

Добавляет новый элемент в коллекцию элементов OPTION этого элемента SELECT . Этот метод эквивалентен методу appendChild интерфейса Node, если параметр before равен null . Во всех остальных случаях он эквивалентен методу insertBefore родительского элемента before.

Параметры:: element — добавляемый элемент.; before — элемент, перед которым нужно вставить новый элемент, или null для добавления в конец списка.
Выбрасывает исключение:: DOMException — NOT_FOUND_ERR: возникает, если before не является потомком элемента SELECT.

remove

void remove(int index)

Удаляет элемент из коллекции элементов OPTION этого элемента SELECT . Ничего не делает, если элемента с указанным индексом нет.

Параметры:: index — индекс удаляемого элемента, начиная с 0.

blur

void blur()

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

focus

void focus()

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

© 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.