imagesNN 3 IE 4 DOM 1

ドキュメントに含まれるすべての imag オブジェクトのコレクション (配列) です。このオブジェクトは、イメージをオブジェクトとして処理するブラウザのみで実装されています。したがって、この配列オブジェクトの有無を、イメージをスワップまたは事前読み込みするステートメントの条件をテストするためのスイッチとして使用できます。次に例を示します。

if (document.images) {
    // process img element objects here
}
 

Macintosh 版 Internet Explorer 3.01 では、イメージをオブジェクトとして処理します。

 
オブジェクト参照
 
document.images
 
オブジェクト固有のプロパティ
 
length
 
オブジェクト固有のメソッド
 
item()namedItem()tags()urns()
lengthNN 3 IE 4 DOM 1

読み取り専用

コレクションに含まれる要素の数を返します。

 
 
var howMany = document.images.length;
 

整数

item()NN 6 IE 4 DOM 1

item(index[, subindex]) item(index)

インデックス値 (または IE の場合には index 値と subindex 値も可能) に一致する要素に対応する 1 つのイメージオブジェクトまたはイメージオブジェクトのコレクションを返します。

 
パラメータ
 
  • パラメータに 0 から始まる整数値を指定した場合 (Netscap 6 では必{) は、ソースコード順序 (現在の要素内でのネスト順序) で指定されたアイテムに対応する 1 つの要素が戻り値として返されます。パラメータに文字列を指定した場合は、その文字列と同じ id プロパティまたは name プロパティを持つ要素のコレクションが返されます。
  • IE では、最初のパラメータで文字列を指定した場合、2 番目のパラメータで 0 から始まる整数値を指定することにより、最初のパラメータ文字列と同じ id プロパティまたは name プロパティを持つコレクションの中から、指定した要素を取得できます。
 
戻り値

1 つのオブジェクト、またはオブジェクトのコレクション (配列)。パラメータに一致する要素がない場合、null が返されます。

namedItem()NN 6 IE 6 DOM 2

namedItem(IDOrName)

パラメータの文字列と一致する要素に対応する 1 つのオブジェクトを返します。

 
パラメータ
 
  • 目的の要素の id 属性または name 属性と同じ値を示す文字列
 
戻り値

オブジェクトへの参照。パラメータに一致する要素がない場合、null が返されます。

tags()NN なし IE 4 DOM なし

tags(tagName)

現在のコレクション内にあるすべてのオブジェクトのうち、tagName パラメータと同じタグを持つオブジェクトのコレクションを返します。ここでは、すべての要素が同じ img タグを持つため、冗長的なメソッドです。

 
パラメータ
 
  • document.images.tags("img") のように、要素タグを示す文字列
 
戻り値

オブジェクトのコレクション (配列)。パラメータに一致する要素がない場合、長さが 0 の配列が返されます。

urns()NN なし IE 5(Win) DOM なし

urns(URN)

ビヘイビアが割り当てられており、URN パラメータと一致する URN を持つ、ネストされた要素オブジェクトのコレクションを返します。

 
パラメータ
 
  • ローカルまたは外部のビヘイビアファイルの URN を示す文字列
 
戻り値

オブジェクトのコレクション (配列)。パラメータに一致する要素がない場合、長さが 0 の配列が返されます。