<th>
HTML の <th>
要素は、表のセルのグループ用のヘッダーであるセルを定義します。このグループの性質は、scope
属性と headers
属性で定義します。
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送信してください。
コンテンツカテゴリ | なし |
---|---|
許可されている内容 | フローコンテンツ、ただしヘッダー、フッター、区分コンテンツ、見出しコンテンツを除く。 |
タグの省略 | 開始タグは必須です。 直後に <th> 要素または <td> 要素がある場合、または親要素内で以降のデータがない場合は終了タグを省略可能。 |
許可されている親要素 | <tr> 要素 |
暗黙の ARIA ロール | columnheader or rowheader |
許可されている ARIA ロール | すべて |
DOM インターフェイス | HTMLTableHeaderCellElement |
属性
この要素にはグローバル属性があります。
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"
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 Living Standard th element の定義 |
現行の標準 | |
HTML5 th element の定義 |
勧告 |
ブラウザーの互換性
BCD tables only load in the browser