Interface HTMLSelectElement

継承元:

HTMLElement

プロパティ:

disabled, form, length, multiple, name, options, selectedIndex, size, tabIndex, type, value

メソッド:

add, blur, focus, remove

プロパティ:

• htmlselectelementObject.disabled

  boolean型

  コントロールはこの文脈では利用不可である。 HTML 4.01 の disabled 属性の定義 を参照。
  

• htmlselectelementObject.form

  HTMLFormElement型, 読取専用

  このコントロールを含む FORM 要素。このコントロールがフォームの文脈内にない場合は null。
  

• htmlselectelementObject.length

  unsigned long型

  この SELECT 内のオプションの数。
  

  設定時の例外:

  NOT_SUPPORTED_ERR / DOMException

  長さの設定を実装が許可しない場合。

• htmlselectelementObject.multiple

  boolean型

  true ならば, この SELECT 内で複数の OPTION 要素を選択可能である。 HTML 4.01 の multiple 属性の定義 を参照。
  

• htmlselectelementObject.name

  DOMString型

  フォームコントロールまたはオブジェクトの、フォーム送信時の名前。 HTML 4.01 の name 属性の定義 を参照。
  

• htmlselectelementObject.options

  HTMLOptionsCollection型, 読取専用

  この要素に含まれる OPTION 要素のコレクション。
  

• htmlselectelementObject.selectedIndex

  long型

  選択された option の順序のインデックスで、 0 から始まる。選択された要素がない場合は値 -1 を返す。複数の option が選択されている場合は、最初に選択された option が返される。
  

• htmlselectelementObject.size

  long型

  見えている行数。 HTML 4.01 の size 属性の定義 を参照。
  

• htmlselectelementObject.tabIndex

  long型

  タブ順での要素の位置を表すインデックス。 HTML 4.01 の tabindex 属性の定義 を参照。
  

• htmlselectelementObject.type

  DOMString型, 読取専用

  このフォームコントロールの型。 multiple プロパティが true のとき、これは文字列 "select-multiple" であり、 false のときは "select-one" である。
  

• htmlselectelementObject.value

  DOMString型

  現在のフォームコントロールの値(即ち、現在選択されている option の値)。複数の option が選択されている場合は、これは最初に選択されたオプションの値である。
  

メソッド:

• htmlselectelementObject.add( element, before )

  この SELECT のための OPTION 要素のコレクションに新しい要素を追加する。 before パラメータが null ならば、このメソッドは Node インターフェイスの appendChild メソッドと等価である。他の全ての場合では before の親の insertBefore メソッドと等価である。このメソッドは、新しい要素が OPTION でも OPTGROUP でもないならば、何の効果ももたらさない。

  引数:

  element / HTMLElement

  追加する要素。
  

  before / HTMLElement

  要素で、この直前に挿入する。リストの末尾に挿入する場合は null 。
  

  戻り値:

  (無し)

  例外:

  NOT_FOUND_ERR / DOMException

  before が SELECT 要素の子孫でない場合に発生。

• htmlselectelementObject.blur( )

  キーボードフォーカスをこの要素から離す。

  戻り値:

  (無し)

• htmlselectelementObject.focus( )

  キーボードフォーカスをこの要素に与える。

  戻り値:

  (無し)

• htmlselectelementObject.remove( index )

  この SELECT についての OPTION 要素のコレクションから要素を除去する。与えられたインデックスの要素がない場合は何もしない。

  引数:

  index / long

  除去する項目のインデックス。0 から始まる。
  

  戻り値:

  (無し)

IDL 定義:

interface HTMLSelectElement : HTMLElement {
  readonly attribute DOMString       type;
           attribute long            selectedIndex;
           attribute DOMString       value;
  // Modified in DOM Level 2:
           attribute unsigned long   length;
                                        // raises(DOMException) on setting
  readonly attribute HTMLFormElement form;
  // Modified in DOM Level 2:
  readonly attribute HTMLOptionsCollection options;
           attribute boolean         disabled;
           attribute boolean         multiple;
           attribute DOMString       name;
           attribute long            size;
           attribute long            tabIndex;
  void               add(in HTMLElement element, 
                         in HTMLElement before)
                                        raises(DOMException);
  void               remove(in long index);
  void               blur();
  void               focus();
};

• Back to Document Object Model HTML
• Object Index
• Glossary
• References