org.w3c.dom.html
インタフェース HTMLSelectElement

すべてのスーパーインタフェース:

Element, HTMLElement, Node

public interface HTMLSelectElement
extends HTMLElement

select 要素では、オプションを選択できます。含まれるオプションは、コレクションとして select 要素を通じて直接アクセスできます。HTML 4.0 の SELECT 要素の定義を参照してください。

また、「Document Object Model (DOM) Level 2 Specification」も参照してください。

フィールドの概要

インタフェース org.w3c.dom.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) 新しい要素を SELECT の OPTION 要素のコレクションに追加します。
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) SELECT の OPTION 要素のコレクションから要素を削除します。
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)

インタフェース org.w3c.dom.html.HTMLElement から継承されたメソッド

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

インタフェース org.w3c.dom.Element から継承されたメソッド

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

インタフェース org.w3c.dom.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()

このフォームコントロールの種類。multiple 属性が true のときは文字列 select-multiple、false のときは文字列 select-one になります。

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()

このコントロールは、このコンテキスト内で利用できません。HTML 4.0 の disabled 属性の定義を参照してください。

setDisabled

void setDisabled(boolean disabled)

getMultiple

boolean getMultiple()

true の場合、SELECT 内で複数の OPTION 要素を選択できます。HTML 4.0 の multiple 属性の定義を参照してください。

setMultiple

void setMultiple(boolean multiple)

getName

String getName()

フォームを使用して送信したときの、フォームコントロール名やフォームオブジェクト名。HTML 4.0 の name 属性の定義を参照してください。

setName

void setName(String name)

getSize

int getSize()

表示されている行数。HTML 4.0 の size 属性の定義を参照してください。

setSize

void setSize(int size)

getTabIndex

int getTabIndex()

Tab キーを押したときに選択される要素の順序を表すインデックス。HTML 4.0 の tabindex 属性の定義を参照してください。

setTabIndex

void setTabIndex(int tabIndex)

add

void add(HTMLElement element,
         HTMLElement before)
         throws DOMException

新しい要素を SELECT の OPTION 要素のコレクションに追加します。before パラメータが null の場合、このメソッドは Node インタフェースの appendChild メソッドと同等です。それ以外の場合は、before の親に対する insertBefore メソッドと同等です。

パラメータ:

element - 追加される要素

before - 直前に挿入される要素、あるいはリストの末尾では null

例外:

DOMException - NOT_FOUND_ERR:before が SELECT 要素の子孫でない場合に発生する

remove

void remove(int index)

SELECT の OPTION 要素のコレクションから要素を削除します。指定したインデックスを持つ要素がない場合は何も行いません。

パラメータ:

index - 削除する項目を表す、0 から始まるインデックス

blur

void blur()

キーボードフォーカスを要素から削除します。

focus

void focus()

キーボードフォーカスを要素に与えます。