legend | NN 6 IE 4 DOM 1 | |
legend オブジェクトは legend 要素に対応するオブジェクトです。また、legend 要素は、フォームまたはフォームコントロールのグループに関連付けられた fieldset 要素内にネストしてそのすぐ後に配置する必要があります。 |
||
相当する HTML コード | ||
<legend> |
||
オブジェクト参照 | ||
[window.]document.getElementById("elementID")
|
||
オブジェクト固有のプロパティ | ||
|
||
オブジェクト固有のメソッド | ||
なし |
||
オブジェクト固有のイベントハンドラープロパティ | ||
なし |
align | NN 6 IE 4 DOM 1 |
読み書き | |
fieldset 要素に対する legend 要素の位置揃えを制御します。Internet Explorer 4 では許容値が常に機能するとは限りません。必要な設定がページのユーザーが利用するすべての OS で正常に機能するかどうかを確認してください。 |
|
例 | |
document.getElementById("myLegend").align = "center"; |
|
値 | |
bottom、center、left、right、top のいずれかの定数を示す文字列 |
|
既定値 | |
left |
form | NN 6 IE 5(Mac)/6(Win) DOM 1 |
読み取り専用 | |
ドキュメントツリー内ですぐ外側にある form 要素オブジェクトへの参照を返します。同じ form 要素内に複数の legend 要素オブジェクトが存在する場合、それらの参照先はすべて同じ form 要素オブジェクトになります。 |
|
例 | |
var theForm = document.getElementById("myLegend").form; |
|
値 | |
form 要素オブジェクトへの参照 |
|
既定値 | |
なし |
accessKey | NN なし IE 4 DOM 1 |
読み書き | |
要素にフォーカスを移動するため (一部のブラウザ)、またはフォームコントロールやリンクアクションをアクティブにするための単一の文字キーです。リンクをアクティブにするためにアクセスキーと一緒に修飾キー (Ctrl、Alt、または Command) を押す必要があるかどうかは、使用するブラウザと OS によって決まります。Windows 版 IE 5 以降および Netscape 6 では、Alt キーを押す必要があり、文字キーの大文字と小文字は区別されません。Macintosh 版 IE 5 以降および Netscape 6 では、アクションを実行するには Ctrl キーを押す必要があります。 |
|
広く使用されている共通プロパティとしてここに記載されていますが、厳密にはすべての実装に当てはまるわけではありません。Netscape 6 (W3C DOM の場合) では、このプロパティが認識される要素は、a、area、button、input、label、legend、および textarea だけです。IE 4 では、これに applet、body、div、embed、isindex、marquee、object、select、span、table、および td が追加されています。ただし、label および legend は削除されました。IE 5 では、他のすべての表示可能な要素が追加されていますが、注意が必要です。input 要素とその他のフォーム関連要素の場合を除き、IE 5 以降ではアクセラレータキーの組み合わせで要素にフォーカスを移動するには、要素に tabindex 属性および tabIndex プロパティ値も (すべての値が 0 の場合でも) 指定する必要があります。Netscape では現在のバージョン 7 で、スクリプトによってプロパティ値を変更しても、UI のビヘイビアは変更されません。 |
|
例 | |
document.links[3].accessKey = "n"; |
|
値 | |
単一の英数字および句読点を示すキーボード文字 |
|
既定値 | |
空の文字列 |
clientHeight、clientWidth | NN 7 IE 4 DOM なし |
読み取り専用 | |
これらのプロパティは、要素のコンテンツの高さと幅を示します。ただし、IE では OS ごとのバージョンや、DOCTYPE 宣言によって切り替えられる互換モードによって、要素の余白がわずかに異なります。Macintosh 版 IE では、すべての要素タイプで使用できません。Netscape 7 では、要素のコンテンツが表示可能領域に収まる場合、値が 0 になります。表示領域に収まらない場合、値は表示可能領域のサイズとなります。たとえば、document.body 要素に対するブラウザウィンドウのコンテンツ領域です。詳細については、本章の 9.2 節を参照してください。 |
|
例 | |
var midHeight = document.body.clientHeight/2; |
|
値 | |
ピクセル数を示す整数 |
|
既定値 | |
0 |
clientHeight、clientWidth | NN 7 IE 4 DOM なし |
読み取り専用 | |
これらのプロパティは、要素のコンテンツの高さと幅を示します。ただし、IE では OS ごとのバージョンや、DOCTYPE 宣言によって切り替えられる互換モードによって、要素の余白がわずかに異なります。Macintosh 版 IE では、すべての要素タイプで使用できません。Netscape 7 では、要素のコンテンツが表示可能領域に収まる場合、値が 0 になります。表示領域に収まらない場合、値は表示可能領域のサイズとなります。たとえば、document.body 要素に対するブラウザウィンドウのコンテンツ領域です。詳細については、本章の 9.2 節を参照してください。 |
|
例 | |
var midHeight = document.body.clientHeight/2; |
|
値 | |
ピクセル数を示す整数 |
|
既定値 | |
0 |
clientLeft、clientTop | NN なし IE 4 DOM なし |
読み取り専用 | |
これらのプロパティは、要素の余白を含む領域内での、要素コンテンツの左上隅の座標を示します。ただし、IE では OS ごとのバージョンによって、わずかに値が異なります。Macintosh 版 IE では、すべての要素タイプで使用できません。詳細については、本章の 9.2 節を参照してください。offsetLeft プロパティと offsetTop プロパティ (Netscape 6 も含む) を使用すると、インライン要素の配置に関してより有用な情報が得られます。要素の位置変更など、CSS によって配置されている要素に対しては、left と top、および pixelLeft と pixelTop (IE のみ) などの style オブジェクトプロパティを使用してください。 |
|
値 | |
ピクセル数を示す整数 |
|
既定値 | |
0 |
clientLeft、clientTop | NN なし IE 4 DOM なし |
読み取り専用 | |
これらのプロパティは、要素の余白を含む領域内での、要素コンテンツの左上隅の座標を示します。ただし、IE では OS ごとのバージョンによって、わずかに値が異なります。Macintosh 版 IE では、すべての要素タイプで使用できません。詳細については、本章の 9.2 節を参照してください。offsetLeft プロパティと offsetTop プロパティ (Netscape 6 も含む) を使用すると、インライン要素の配置に関してより有用な情報が得られます。要素の位置変更など、CSS によって配置されている要素に対しては、left と top、および pixelLeft と pixelTop (IE のみ) などの style オブジェクトプロパティを使用してください。 |
|
値 | |
ピクセル数を示す整数 |
|
既定値 | |
0 |
scrollHeight、scrollWidth | NN 7 IE 4 DOM なし |
読み取り専用 | |
これらのプロパティは、要素のピクセル長を返します。ブラウザウィンドウの表示領域よりも大きい要素を含みます。元は、スクロールした要素および要素のスクロールに影響を与えた要素 (body、button、caption、div、fieldset、legend、marquee、および textarea) に対して IE 4 で実装されました。要素で表示される部分のみのサイズを返す、スクロール可能な要素に対する clientHeight プロパティおよび clientWidth プロパティと対照的です。ただし、Macintosh 版 IE では scroll- プロパティの解釈が異なり、表示される部分のサイズが返されます。 |
|
Windows 版 IE 5 からは、すべての HTML 要素がこれらのプロパティを持つようになり、スクロールしない要素の値は、offsetHeight プロパティおよび offsetWidth プロパティと同じになります。Netscape 7 では、すべての要素に対してこれらのプロパティが実装され、表示されるかどうかに関係なく、要素の高さと幅が返されます。いずれにせよ、body などの主要な要素ではこれらのプロパティの意味が曖昧なため、プラットフォーム間の操作の障害になる可能性がある点に注意してください。 |
|
例 | |
var midPoint = document.body.scrollHeight/2; |
|
値 | |
正の整数または 0 |
|
既定値 | |
なし |
scrollHeight、scrollWidth | NN 7 IE 4 DOM なし |
読み取り専用 | |
これらのプロパティは、要素のピクセル長を返します。ブラウザウィンドウの表示領域よりも大きい要素を含みます。元は、スクロールした要素および要素のスクロールに影響を与えた要素 (body、button、caption、div、fieldset、legend、marquee、および textarea) に対して IE 4 で実装されました。要素で表示される部分のみのサイズを返す、スクロール可能な要素に対する clientHeight プロパティおよび clientWidth プロパティと対照的です。ただし、Macintosh 版 IE では scroll- プロパティの解釈が異なり、表示される部分のサイズが返されます。 |
|
Windows 版 IE 5 からは、すべての HTML 要素がこれらのプロパティを持つようになり、スクロールしない要素の値は、offsetHeight プロパティおよび offsetWidth プロパティと同じになります。Netscape 7 では、すべての要素に対してこれらのプロパティが実装され、表示されるかどうかに関係なく、要素の高さと幅が返されます。いずれにせよ、body などの主要な要素ではこれらのプロパティの意味が曖昧なため、プラットフォーム間の操作の障害になる可能性がある点に注意してください。 |
|
例 | |
var midPoint = document.body.scrollHeight/2; |
|
値 | |
正の整数または 0 |
|
既定値 | |
なし |
scrollLeft、scrollTop | NN 7 IE 4 DOM なし |
読み書き | |
要素内にある物理コンテンツの実際の左端と上端から、コンテンツの表示部分の左端または上端までの距離をピクセル単位で示します。これらのプロパティを設定すると、スクリプトを使用して、スクロール可能なコンテナに含まれているコンテンツ、つまり textarea 要素にあるテキストや、ブラウザウィンドウまたはフレーム内のドキュメント全体などのスクロールを調整できます。コンテンツがスクロールされない場合、両方のプロパティの値が 0 になります。scrollTop プロパティを 15 に設定すると、ウィンドウ内のドキュメントを上に 15 ピクセルだけスクロールします。scrollLeft プロパティは、明示的に変更しない限り影響を受けません。プロパティ値は、ユーザーがスクロールバーを使用するたびに変更されます。このことは、Windows 版 IE ではイベントオフセットのサイズの座標系はブラウザウィンドウ内のページの表示領域に関係するため、イベントによって実行される配置処理には重要な場合があります。document.body スクロール要素を追加して、イベント座標を body 要素内にあるコンテンツの位置に揃える必要があります。第 6 章の要素のドラッグに関する例を参照してください。Windows 版 IE 5 以降、scrollLeft プロパティと scrollTop プロパティはすべての HTML 要素オブジェクトで使用できますが、スクロールできない要素の値は 0 になります。 |
|
例 | |
document.body.scrollTop = 40; |
|
値 | |
正の整数または 0 |
|
既定値 | |
0 |
scrollLeft、scrollTop | NN 7 IE 4 DOM なし |
読み書き | |
要素内にある物理コンテンツの実際の左端と上端から、コンテンツの表示部分の左端または上端までの距離をピクセル単位で示します。これらのプロパティを設定すると、スクリプトを使用して、スクロール可能なコンテナに含まれているコンテンツ、つまり textarea 要素にあるテキストや、ブラウザウィンドウまたはフレーム内のドキュメント全体などのスクロールを調整できます。コンテンツがスクロールされない場合、両方のプロパティの値が 0 になります。scrollTop プロパティを 15 に設定すると、ウィンドウ内のドキュメントを上に 15 ピクセルだけスクロールします。scrollLeft プロパティは、明示的に変更しない限り影響を受けません。プロパティ値は、ユーザーがスクロールバーを使用するたびに変更されます。このことは、Windows 版 IE ではイベントオフセットのサイズの座標系はブラウザウィンドウ内のページの表示領域に関係するため、イベントによって実行される配置処理には重要な場合があります。document.body スクロール要素を追加して、イベント座標を body 要素内にあるコンテンツの位置に揃える必要があります。第 6 章の要素のドラッグに関する例を参照してください。Windows 版 IE 5 以降、scrollLeft プロパティと scrollTop プロパティはすべての HTML 要素オブジェクトで使用できますが、スクロールできない要素の値は 0 になります。 |
|
例 | |
document.body.scrollTop = 40; |
|
値 | |
正の整数または 0 |
|
既定値 | |
0 |
blur() | NN 2 IE 3 DOM 1 |
現在のオブジェクトからフォーカスを削除し、オブジェクトの onblur イベントを呼び出します。IE の最新バージョンを除いたすべてのブラウザで、フォーカスとブラーに対応する要素 (イベントとメソッドの両方) の範囲が制限されています。第 8 章の共通 tabindex 属性を参照してください。下位互換性を保つには、テキスト input 要素や textarea 要素など、フォーカスを設定できる要素に blur() メソッドを適用します。要素を無効にする手段を持たないブラウザでは、たとえば、onfocus="this.blur();" 属性をテキスト input 要素に割り当ててフィールドを広範囲で無効にすることができます。これは、粗雑な方法ではありますが、下位互換性を保つには効果的です。 |
|
同じページでは blur() メソッドと focus() メソッドを控えめに使用してください。処理中に警告ダイアログボックスが表示されると、ブラーとフォーカスの無限ループを間違って実行してしまう可能性があります。また、1 つのオブジェクトで blur() メソッドを呼び出すと、window オブジェクトなど、別のオブジェクトが onfocus イベントを受け取ることがあります。 |
|
パラメータ | |
なし |
|
戻り値 | |
なし |
focus() | NN 2 IE 3 DOM 1 |
現在のオブジェクトにフォーカスを設定し、オブジェクトの onfocus イベントを呼び出します。IE の最新バージョンを除いたすべてのブラウザで、フォーカスとブラーに対応する要素 (イベントとメソッドの両方) の範囲が制限されています。第 8 章の共通 tabindex 属性を参照してください。下位互換性を保つには、テキスト input 要素や textarea 要素など、フォーカスを設定できる要素に focus() メソッドを適用します。 |
|
テキストボックスにフォーカスを設定し、ボックス内の全テキストをあらかじめ選択するには、focus() メソッドに続いて select() メソッドを要素に使用します。警告ダイアログボックスを閉じるときなど、ウィンドウの切り替えが発生する場合は、これらのメソッドを個別の関数内に配置し、ダイアログの alert() メソッドに続く setTimeout() メソッドからその関数を呼び出します。Windows 版 IE では、この方法で一連のステートメントが正しく実行されます。 |
|
パラメータ | |
なし |
|
戻り値 | |
なし |