Common DOM API

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_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
 
メソッドの概要
 void add(HTMLElement element, HTMLElement before)
          新しい要素を SELECTOPTION 要素のコレクションに追加 します。
 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)
          SELECTOPTION 要素のコレクションから要素を削除 します。
 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, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS
 
インタフェース org.w3c.dom.Node から継承したメソッド
appendChild, cloneNode, getAttributes, getChildNodes, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, hasAttributes, hasChildNodes, insertBefore, isSupported, normalize, removeChild, replaceChild, setNodeValue, setPrefix
 

メソッドの詳細

getType

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


getSelectedIndex

public int getSelectedIndex()
選択したオプションを表す、順序付けされた 0 から始まるインデックス。要素が選択 されていない場合は値として -1 が返されます。複数のオプションを選択した場合は、 最初に選択したオプションのインデックスが返されます。


setSelectedIndex

public void setSelectedIndex(int selectedIndex)

getValue

public String getValue()
フォームコントロールの現在の値。


setValue

public void setValue(String value)

getLength

public int getLength()
SELECT 内のオプション数。


getForm

public HTMLFormElement getForm()
このコントロールが含まれる FORM 要素を返します。コントロールが フォームのコンテキスト内にない場合は、null を返します。


getOptions

public HTMLCollection getOptions()
この要素に含まれる OPTION 要素のコレクション。


getDisabled

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


setDisabled

public void setDisabled(boolean disabled)

getMultiple

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


setMultiple

public void setMultiple(boolean multiple)

getName

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


setName

public void setName(String name)

getSize

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


setSize

public void setSize(int size)

getTabIndex

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


setTabIndex

public void setTabIndex(int tabIndex)

add

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

パラメータ:
element - 追加される要素
before - 直前に挿入される要素、あるいはリストの末尾では null
例外:
DOMException - NOT_FOUND_ERR:beforeSELECT 要素の子孫でない場合に 発生する

remove

public void remove(int index)
SELECTOPTION 要素のコレクションから要素を削除 します。指定したインデックスを持つ要素がない場合は何も行いません。

パラメータ:
index - 削除する項目を表す、0 から始まるインデックス

blur

public void blur()
キーボードフォーカスを要素から削除します。


focus

public void focus()
キーボードフォーカスを要素に与えます。


Common DOM API

バグや機能要求の報告
Java は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.