trNN 6 IE 4 DOM 1

tr オブジェクトは tr 要素に対応するオブジェクトです。Macintosh 版 IE 4 での実装には不備があるため、これらの要素オブジェクトにスクリプトでアクセスする機能が完全ではありません。

 
相当する HTML コード
 
<tr>
 
オブジェクト参照
 
[window.]document.getElementById("elementID")
[window.]document.getElementById("tableID").rows[i]
 
オブジェクト固有のプロパティ
 
alignbgColorborderColorborderColorDark
borderColorLightcells[]chchOff
heightrowIndexsectionRowIndexvAlign
 
オブジェクト固有のメソッド
 
deleteCell()insertCell()
 
オブジェクト固有のイベントハンドラープロパティ

なし

alignNN 6 IE 4 DOM 1

読み書き

その行にあるすべてのセル内のコンテンツの横方向の位置揃えを示します。

 
 
document.getElementById("myTR").align = "center";
 

横方向の位置揃えを指定する centerleftright のいずれかの定数

 
既定値

left

bgColorNN 6 IE 4 DOM 1

読み書き

現在の行にあるテーブルセルの背景色を示します。この色の設定は、スタイルシートの backgroundColor プロパティには反映されません。bgcolor 属性や bgColor プロパティの設定に色の名前の英単語を使用した場合でも、戻り値では常に RGB 値の 16 進数表記が返されます。

 
 
document.getElementById("myTR").bgColor = "yellow";
 

RGB 値の 16 進数表記または色の名前の英単語。使用できる色の名前については、付録 A を参照してください。

 
既定値

ブラウザと OS によって異なります。

borderColorNN なし IE 4 DOM なし

読み書き

要素のボーダーの色を示します。Internet Explorer では、セルの内側のボーダーを構成する 4 辺すべてにこの色が適用されます。したがって、隣り合っているセルの色が衝突することはありません。

 
 
document.getElementById("myTR").borderColor = "salmon";
 

RGB 値の 16 進数表記または色の名前の英単語。空の文字列を設定した場合、"#000000" (黒) として解釈されます。使用できる色の名前については、付録 A を参照してください。

 
既定値

OS によって異なります。

borderColorDark、borderColorLightNN なし IE 4 DOM なし

読み書き

Internet Explorer では、ページの背景色やデフォルト色の周りに明るい線と暗い線を適切に配置することによってテーブルボーダーの 3D 効果が作成されます。borderColorDark (セルの左と上の辺) プロパティと borderColorLight (セルの右と下の辺) プロパティに値を設定して、ボーダーの暗い線と明るい線に使用する色を個別に制御できます。

 

通常の場合、この 2 つのプロパティにはお互いの補色を設定します。ただし、必ずしも borderColorDark に暗い色を設定する必要はありません。これらの属性はセルの特定の辺を制御するためのもので、各属性によってボーダーのどの辺が設定されるかが分かるような名前が付いているだけです。

 
 
document.getElementById("myTR").borderColorDark = "blue";
document.getElementById("myTR").borderColorLight = "cornflowerblue";
 

RGB 値の 16 進数表記または色の名前の英単語。空の文字列を設定した場合、"#000000" (黒) として解釈されます。使用できる色の名前については、付録 A を参照してください。

 
既定値

OS によって異なります。

cells[]NN 6 IE 4 DOM 1

読み取り専用

テーブルの行内にネストされている td 要素または th 要素のコレクションを返します。コレクション内の各アイテムはソースコード順序で指定されています。

 
 
var allRowCells = document.getElementById("myTR").cells;
 

cells コレクションオブジェクトへの参照

 
既定値

長さ 0 の配列

chNN 6 IE 5(Mac)/6(Win) DOM 1

読み書き

行内のテキストセルの位置揃え点として使用するテキスト文字を示します。このプロパティは、通常、"char" に設定された align 属性の値のみを対象とします。実際には、IE と Navigator のいずれでもこのプロパティは反映されません。

 
 
document.getElementById("myTR").ch = ".";
 

1 文字の文字列

 
既定値

なし

chOffNN 6 IE 5(Mac)/6(Win) DOM 1

読み書き

char 属性で設定された文字がセル内で表示されるオフセット点を示します。実際には、IE と Navigator のいずれでもこのプロパティは反映されません。

 
 
document.getElementById("myTR").chOff = "80%";
 

ピクセル数、またはセル内でのパーセント値を示す文字列

 
既定値

なし

heightNN なし IE 5 DOM なし

読み書き

行の高さをピクセル数またはパーセント値で示します。行の高さを動的に変更する場合は、height プロパティではなく、要素の style.height の値を調整してください。

 

ピクセル数、または行内でのパーセント値を示す文字列

 
既定値

なし

rowIndexNN 6 IE 4 DOM 1

読み取り専用

テーブル全体にある他のすべての tr 要素に対する現在の行の位置を表す、0 を基準とした整数を返します。この値は tr 要素のソースコード順序に基づきます。

 
 
var whichRow = document.getElementById("myTR").rowIndex;
 

整数

 
既定値

なし

sectionRowIndexNN 6 IE 4 DOM 1

読み取り専用

この行グループにある他のすべての tr 要素に対する現在の行の位置を表す、0 を基準とした整数を返します。行グループは、theadtbodytfoot のいずれかの要素です。この値は tr 要素のソースコード順序に基づきます。

 
 
var whichRow = document.getElementById("myTR").sectionRowIndex;
 

整数

 
既定値

なし

vAlignNN 6 IE 4 DOM 1

読み書き

現在の行にあるセル内でのテキストの縦方向の行揃えを示します。

 
 
document.getElementById("myTR").vAlign = "baseline";
 

baselinebottommiddletop のいずれかの定数を示す文字列。大文字と小文字は区別されません。

 
既定値

middle

deleteCell()NN 6 IE 4 DOM 1

deleteCell(index)

現在の tr 要素内にネストされている td 要素または th 要素を削除します。パラメータには、行の cells コレクション内で削除するアイテムを示す 0 から始まる整数を指定します。

 
パラメータ
 
  • ソースコード順序 (現在の要素内でのネスト順) で並ぶ td 要素のうち、指定する要素を示す 0 から始まる整数
 
戻り値

なし

insertCell()NN 6 IE 4(Win) DOM 1

insertCell(index)

現在の tr 要素内にネストされている td 要素を挿入します。パラメータには、cells コレクション内の新しいセルを挿入する位置を示す 0 から始まる整数インデックスを指定します。Internet Explorer では、-1 を指定することにより、コレクションの末尾へのセルの追加を簡略化できます。セルを追加すると空の要素が追加されます。各種のドキュメントツリー変更方式を使って、この要素にコンテンツを追加してください。Macintosh 版 IE (バージョン 5.1 を含む) では、テーブルに行とセルを追加するスクリプトが正常に機能せず、巨大な行とセルが作成されます。ネストされていないテーブルの場合には、テーブルセクションオブジェクトの便利なメソッドを使用する代わりに、ドキュメントツリー内でノードを作成および挿入する一般的な方法を使用することもできます。

 
パラメータ
 
  • cells コレクション内で新しいセルを挿入する位置の下にある行を示す 0 から始まる整数
 
戻り値

新たに挿入されたセルへの参照

clientHeight、clientWidthNN 7 IE 4 DOM なし

読み取り専用

これらのプロパティは、要素のコンテンツの高さと幅を示します。ただし、IE では OS ごとのバージョンや、DOCTYPE 宣言によって切り替えられる互換モードによって、要素の余白がわずかに異なります。Macintosh 版 IE では、すべての要素タイプで使用できません。Netscape 7 では、要素のコンテンツが表示可能領域に収まる場合、値が 0 になります。表示領域に収まらない場合、値は表示可能領域のサイズとなります。たとえば、document.body 要素に対するブラウザウィンドウのコンテンツ領域です。詳細については、本章の 9.2 節を参照してください。

 
 
var midHeight = document.body.clientHeight/2;
 

ピクセル数を示す整数

 
既定値

0

clientHeight、clientWidthNN 7 IE 4 DOM なし

読み取り専用

これらのプロパティは、要素のコンテンツの高さと幅を示します。ただし、IE では OS ごとのバージョンや、DOCTYPE 宣言によって切り替えられる互換モードによって、要素の余白がわずかに異なります。Macintosh 版 IE では、すべての要素タイプで使用できません。Netscape 7 では、要素のコンテンツが表示可能領域に収まる場合、値が 0 になります。表示領域に収まらない場合、値は表示可能領域のサイズとなります。たとえば、document.body 要素に対するブラウザウィンドウのコンテンツ領域です。詳細については、本章の 9.2 節を参照してください。

 
 
var midHeight = document.body.clientHeight/2;
 

ピクセル数を示す整数

 
既定値

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 では、この方法で一連のステートメントが正しく実行されます。

 
パラメータ

なし

 
戻り値

なし