Интерфейс HTMLSelectElement

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

public interface HTMLSelectElement extends HTMLElement

Элемент select позволяет выбрать один из вариантов. Доступ к содержащимся в нём вариантам можно получить напрямую через элемент select как к коллекции. См. определение элемента SELECT в 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

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

Модификатор и тип	Метод	Описание
`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

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

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

Методы, объявленные в интерфейсе 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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/jdk.xml.dom/org/w3c/dom/html/HTMLSelectElement.html