<th>

HTML の <th> 要素は、表のセルのグループ用のヘッダーであるセルを定義します。このグループの性質は、scope 属性と headers 属性で定義します。

このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送信してください。

属性

この要素にはグローバル属性があります。

abbr

この属性は、セルの内容の簡潔な説明を持ちます。読み上げソフトなど一部のユーザーエージェントは、内容自体の前にこの説明を提供することがあります。

colspan

この属性はセルをいくつの列に広げるかを示す、負でない整数を持ちます。既定値は 1 です。1000 を超える値は正しくないとみなされ、既定値 (1) が設定されるでしょう。

headers

この属性は、空白文字で区切られた文字列のリストを持ちます。各々の文字列は、この要素に当てはめる <th> 要素の id 属性と対応します。

rowspan

この属性はセルをいくつの行に広げるかを示す、負でない整数を持ちます。既定値は 1 です。0 を設定した場合は、セルが属する表セクション (<thead>, <tbody>, <tfoot>, 暗黙的に定義されたものも含む) の終端まで拡張します。 65534 より大きな値は、 65534 に切り詰めます。

scope

これは列挙型の属性で、この (<th> で定義されている) 見出し要素が関連するセルを定義します。次の値を取ることができます。

• row: この見出しはその行に属するすべてのセルに関連します。
• col: この見出しはその列に属するすべてのセルに関連します。
• rowgroup: この見出しは行グループに属し、その中のすべてのセルに関連します。これらのセルは <table> 要素の dir 属性の値によって、見出しの右又は左に配置されます。
• colgroup: この見出しは列グループに属し、その中のすべてのセルに関連します。.
• auto

この属性が指定されなかった場合の既定値は auto です。

非推奨の属性

align HTML5 で廃止

この列挙属性は各セルの中身について、水平方向の配置方法を制御します。以下の値を指定可能です。

• left: 中身をセルの左側に揃えます。
• center: 中身をセル内で中央揃えにします。
• right: 中身をセルの右側に揃えます。
• justify (テキストのみ): セルの中で幅が全体にわたるように、中身が引き延ばされます。
• char (テキストのみ): テキストコンテンツを特定の文字に対して、最小のオフセットで揃えます。特定の文字は char 属性および charoff 属性で定義します。未実装 (参照 バグ 2212)

この属性を設定しない場合は、値が left であるとみなされます。

注: この属性は最新の標準仕様で廃止された (サポートされていない) ため、使用しないでください。

• left, center, right, justify の値と同様の効果を得るには、 CSS の text-align プロパティを使用してください。
• CSS3 で char の値と同様の効果を得るには、 text-align プロパティに char で使用する値と同じものを指定してください。 CSS3 では 未実装

axis HTML5 で廃止

この属性は、空白文字で区切られた文字列のリストを持ちます。各文字列は、このヘッダーを適用するセルグループの id です。

注: この属性は最新の標準で廃止されているため、使用しないでください。代わりに scope 属性を使用してください。

bgcolor

この属性は、列の各セルの背景色を定義します。値は sRGB で定義された6桁の16進数値のいずれかで、先頭に '#' を付加します。16個のあらかじめ定義された色文字列から、1つを使用することができます。

	black = "#000000"		green = "#008000"
	silver = "#C0C0C0"		lime = "#00FF00"
	gray = "#808080"		olive = "#808000"
	white = "#FFFFFF"		yellow = "#FFFF00"
	maroon = "#800000"		navy = "#000080"
	red = "#FF0000"		blue = "#0000FF"
	purple = "#800080"		teal = "#008080"
	fuchsia = "#FF00FF"		aqua = "#00FFFF"

注: この属性は標準外であり Internet Explorer の一部バージョンしか実装していませんので、使用しないでください。 <th> 要素は CSS を使用してスタイル付けをしてください。 bgcolor 属性と同様の効果を与えるには、 CSS の background-color プロパティを適切な <td> または <th> 要素で使用してください。

char HTML5 で廃止

この属性は、列内のセルで揃える文字を設定します。典型的な値に、数値や金額を揃えようとするときのピリオド (.) があります。 align 属性を char に設定していない場合は、この属性を無視します。

注: この属性は最新の標準で廃止されているため、使用しないでください。 CSS3 で同じ効果を得るには、 text-align プロパティの最初の値としてその文字を設定することができます。 CSS3 では未実装

charoff HTML5 で廃止

この属性は、 char 属性で指定した揃え文字から列のデータをオフセットする文字数を示します。

注: この属性は最新の標準で廃止されているため、使用しないでください。

height 非推奨 HTML4, HTML5 で廃止

この属性はセルの高さの推奨値を定義するために使用されます。

注: この属性は最新の標準で廃止されているため、使用しないでください。代わりに CSS の height プロパティを使用してください。

valign HTML5 で廃止

この属性は、表本体の各行のセルにおける垂直方向のテキスト配置方法を指定します。以下の値が指定可能です。

• baseline: テキストを可能な限りセルの下端に近づけますが、下端ではなく文字のベースラインに揃えます。文字がサイズ全体に渡る場合は、 bottom と同じ効果になります。
• bottom: テキストを可能な限りセルの下端に近づけて配置します。
• middle: テキストをセル内の中央に置きます。
• top: テキストを可能な限りセルの上端に近づけて配置します。

注: この属性は最新の標準で廃止されているため、使用しないでください。代わりに CSS の vertical-align プロパティを使用してください。

width 非推奨 HTML4, HTML5 で廃止

この属性は、セルの推奨する幅を定義します。 cellspacing および cellpadding プロパティで追加のスペースを追加し、また <col> の幅も影響を与えます。通常、列の幅が特定のセルを正常に表示できないほど狭く、またそのようなセルが存在する場合は、表示する際に幅を広げるでしょう。

注: この属性は最新の標準で廃止されているため、使用しないでください。代わりに CSS の width プロパティを使用してください。

例

<th> 要素の使用例については、 <table> を参照してください。

仕様書

ブラウザーの互換性

関連情報

• 他の表関連 HTML 要素: <caption>, <col>, <colgroup>, <table>, <tbody>, <td>, <tfoot>, <thead>, <tr>