options | NN 2 IE 3 DOM 1 | |||||
select オブジェクトにネストされた option 要素の配列です。 |
||||||
オブジェクト参照 | ||||||
[window.]document.formName.selectName.options [window.]document.forms[i].elements[i].options [window.]document.getElementById("selectElementID").options |
||||||
オブジェクト固有のプロパティ | ||||||
|
||||||
オブジェクト固有のメソッド | ||||||
|
length | NN 2 IE 3 DOM 1 |
読み取り専用 | |
コレクションに含まれる要素の数を返します。 |
|
例 | |
var howMany = document.forms[0].mySelect.options.length; |
|
値 | |
整数 |
add() | NN なし IE 4 DOM なし |
add(elementRef[, index]) | |
作成済みの要素を (createElement() メソッドから) 現在のコレクションに追加します。要素は option タイプである必要があります。2 番目のパラメータとしてインデックス値を指定しない限り、デフォルトでは新しい要素はコレクションの最後のアイテムとして追加されます。この場合、そのインデックス位置以降にある既存アイテムの位置は 1 つずつ繰り下がります。次のシーケンス例は select オブジェクトに新しいアイテムを追加します。 var newElem = document.createElement("option"); newElem.text = "Freddy"; newElem.value = "Freddy Mercury"; document.forms[1].rockers.options.add(newElem); |
|
一般的なオブジェクトが最初に作成されます。次にそのプロパティに値が設定されます。その次に、新しい要素が select 要素に追加されます。 |
|
このタスクでブラウザ間の互換性と下位互換性を保つ方法については、option オブジェクトの説明を参照してください。また Netscape 6 で使用できる W3C DOM のアプローチについては、select.add() メソッドの説明を参照してください。 |
|
パラメータ | |
|
|
戻り値 | |
なし |
item() | NN 6 IE 4 DOM 1 |
item(index[, subindex]) item(index) | |
インデックス値 (またはインデックス値とサブインデックス値も可能) に一致する要素に対応する、1 つのオブジェクトまたはオブジェクトのコレクションを返します。 |
|
パラメータ | |
|
|
戻り値 | |
1 つのオブジェクト、またはオブジェクトのコレクション (配列)。パラメータに一致する要素がない場合、null が返されます。 |
namedItem() | NN 6 IE 6 DOM 1 |
namedItem("ID") | |
パラメータの文字列と一致する要素に対応する 1 つの option オブジェクトを返します。 |
|
パラメータ | |
|
|
戻り値 | |
1 つの option オブジェクト。パラメータに一致する要素がない場合、null が返されます。 |
remove() | NN なし IE 4 DOM なし |
remove(index) | |
現在のコレクションから要素を削除します。select 要素に属するコレクションから削除する option 要素を選び、0 から始まるインデックス値で指定します。次の例は select オブジェクトから最初のアイテムを削除します。 document.forms[1].rockers.options.remove(0); |
|
Navigator では、option 要素を削除するプロセスはまったく異なります。アイテムを削除するには、コレクション内のアイテムに null を指定します。たとえば、前述の IE 例に相当する Navigator での例は次のようになります。 document.forms[1].rockers.options[0] = null; |
|
select オブジェクトを削除するプロセスの違いに関わりなく、どのブラウザでも、options 配列の長さは収縮されて表示されます。 |
|
パラメータ | |
|
|
戻り値 | |
なし |
urns() | NN なし IE 5(Win) DOM なし |
urns(URN) | |
all.urns() メソッドを参照してください。 |