HTML の <td>
要素は、表でデータを包含するセルを定義します。これは表モデルに関与します。
このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 https://github.com/mdn/interactive-examples をクローンしてプルリクエストを送信してください。
コンテンツカテゴリ | 区分化ルート |
---|---|
許可されている内容 | フローコンテンツ |
タグの省略 | 開始タグは必須です。 直後に <th> 要素または <td> 要素がある場合、または親要素内で以降のデータがない場合は終了タグを省略可能。 |
許可されている親要素 | <tr> 要素 |
暗黙の ARIA ロール | cell (<table> 要素の子孫である場合) |
許可されている ARIA ロール | すべて |
DOM インターフェイス | HTMLTableDataCellElement |
属性
この要素にはグローバル属性があります。
colspan
- この属性はセルをいくつの列に広げるかを示す、負でない整数を持ちます。既定値は
1
です。1000 を超える値は正しくないとみなされ、既定値 (1) が設定されるでしょう。 headers
- この属性は、空白文字で区切られた文字列のリストを持ちます。各々の文字列は、この要素に当てはめる
<th>
要素の id 属性と対応します。 rowspan
- この属性はセルをいくつの行に広げるかを示す、負でない整数を持ちます。デフォルト値は
1
です。0
を設定した場合は、セルが属する表セクション (<thead>
,<tbody>
,<tfoot>
) の終端 (暗黙的に定義されるものであっても) まで拡張します。65534 より大きな値は、65534 に切り詰めます。
非推奨の属性
abbr
HTML5 で廃止- この属性は、セルの内容の簡潔な説明を持ちます。読み上げソフトなど一部のユーザーエージェントは、内容自体の前にこの説明を提供することがあります。
注: この属性は最新の標準で廃止されているため、使用しないでください。代わりに、セルの内容を独立した短縮コンテンツそのもので始めることを検討するか、セルの内容として短縮コンテンツを使用して長いコンテンツはセルの説明として title 属性に追加してください。
align
HTML5 で廃止- この列挙属性は各セルの中身について、水平方向の配置方法を制御します。以下の値を指定可能です。
left
: 中身をセルの左側に揃えます。center
: 中身をセル内で中央揃えにします。right
: 中身をセルの右側に揃えます。justify
: 中身がセル内で両端揃えになるように、テキストコンテンツに空白を挿入します。char
: テキストコンテンツを特定の文字に対して、最小のオフセットで揃えます。特定の文字はchar
属性およびcharoff
属性で定義します。未実装 (参照 バグ 2212)
この属性を設定しない場合は、値が
left
であるとみなされます。注: この属性は最新の標準仕様で廃止された (サポートされていない) ため、使用しないでください。left
,center
,right
,justify
の値と同様の効果を得るには、 CSS のtext-align
プロパティを使用してください。- CSS3 で
char
の値と同様の効果を得るには、text-align
プロパティの値char
を使用できます 未実装。
axis
HTML5 で廃止- この属性は、空白文字で区切られた文字列のリストを持ちます。各文字列は、このヘッダーを適用するセルグループの
id
です。注: この属性は最新の標準で廃止されているため、使用しないでください。 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 でchar
と同じ効果を得るには、text-align
プロパティの最初の値としてその文字を設定することができます。 CSS3 では未実装 charoff
HTML5 で廃止- この属性は、 char 属性で指定した揃え文字から列のデータをオフセットする文字数を示します。
注: この属性は最新の標準で廃止されているため、使用しないでください。
height
非推奨 HTML4, HTML5 で廃止- この属性はセルの高さの推奨値を定義するために使用されます。
注: この属性は最新の標準で廃止されているため、使用しないでください。代わりに CSS の
height
プロパティを使用してください。 scope
HTML5 で廃止- これは列挙型の属性で、この (
<th>
で定義されている) 見出し要素が関連するセルを定義します。次の値を取ることができます。注: この属性を表のセル要素に使用することは、最新の仕様書で廃止されました。この属性は<th>
要素のみに、行と列のどちらの見出しであるかを定義するために使用してください。 valign
HTML5 で廃止- この属性は、表本体の各行のセルにおける垂直方向のテキスト配置方法を指定します。以下の値が指定可能です。
baseline
: テキストを可能な限りセルの下端に近づけますが、下端ではなく文字のベースラインに揃えます。文字がサイズ全体に渡る場合は、bottom
と同じ効果になります。bottom
: テキストを可能な限りセルの下端に近づけて配置します。middle
: テキストをセル内の中央に置きます。top
: テキストを可能な限りセルの上端に近づけて配置します。
注: この属性は最新の標準で廃止されているため、使用しないでください。代わりに CSS のvertical-align
プロパティを使用してください。 width
非推奨 HTML4, HTML5 で廃止- この属性は、セルの推奨する幅を定義します。cellspacing 及び cellpadding がスペースを追加し、また
<col>
の幅も影響を与えます。通常、列の幅が特定のセルを正常に表示できないほど狭く、またそのようなセルが存在する場合は、表示する際に幅を広げるでしょう。注: この属性は最新の標準で廃止されているため、使用しないでください。代わりに CSS のwidth
プロパティを使用してください。
例
<td>
要素の使用例については、 <table>
を参照してください。
仕様書
仕様書 | 状態 | 備考 |
---|---|---|
HTML Living Standard td element の定義 |
現行の標準 | |
HTML5 td element の定義 |
勧告 |
ブラウザーの互換性
BCD tables only load in the browser
このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 https://github.com/mdn/browser-compat-data をチェックアウトしてプルリクエストを送信してください。