CSSで、横に長い表をスマホではカード型に並べ替える方法
注文履歴や料金の一覧のような列の多い表は、スマートフォンの画面では横にはみ出し、ページごと横にスクロールしてしまいます。表をレスポンシブにするには、画面が狭いときだけ tr と td を display: block にして、1行を1枚のカードとして縦に並べます。各セルの前には、HTML の data-label 属性に書いた列の名前を ::before で出します。
検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、ヘッドレスの Chromium 153 です。6列・3行の注文の表を作り、ビューポートの横幅を800pxと360pxにして、要素の大きさと、Playwright で取り出したアクセシビリティツリー(読み上げソフトなどに渡る、ページの構造の情報)を調べました。Firefox と Safari、スマートフォンの実機、実際の読み上げソフトでの読み上げは試していません。
何もしないと、表がページの外にはみ出す
検証に使ったのは、次のような表です。caption で表の名前を付け、見出しのセルには scope="col" を付けています。
<table class="orders">
<caption>注文の一覧</caption>
<thead>
<tr>
<th scope="col">注文番号</th>
<th scope="col">注文日</th>
<th scope="col">商品</th>
<th scope="col">数量</th>
<th scope="col">金額</th>
<th scope="col">状態</th>
</tr>
</thead>
<tbody>
<tr>
<td data-label="注文番号">A-1001</td>
<td data-label="注文日">2026-11-01</td>
<td data-label="商品">ステンレスの保温マグ(350ml)</td>
<td data-label="数量">2</td>
<td data-label="金額">4,180円</td>
<td data-label="状態">発送済み</td>
</tr>
<!-- 残りの2行も同じ形 -->
</tbody>
</table>
検証用のページでは、表に次の CSS を当てています。white-space: nowrap は、セルの文字を折り返さないための指定です。
.orders { border-collapse: collapse; }
.orders th, .orders td { padding: 8px 12px; border-bottom: 1px solid #cfd8dc; text-align: left; white-space: nowrap; }
.orders thead th { background: #eefafd; }
横360pxの画面で開くと、表の幅は680.2pxのままで、ページの横幅(scrollWidth)は696pxになりました。右側の「数量」「金額」「状態」の列は、横にスクロールしないと見えません。

画面が狭いときだけ、行をカードにする
横600px以下の画面で、表をカードの形に変える CSS です。
@media (max-width: 600px) {
.orders thead {
position: absolute;
width: 1px;
height: 1px;
overflow: hidden;
clip-path: inset(50%);
white-space: nowrap;
}
.orders,
.orders caption,
.orders tbody,
.orders tr,
.orders td {
display: block;
}
.orders caption {
margin-bottom: 8px;
font-weight: bold;
text-align: left;
}
.orders tr {
margin-bottom: 12px;
padding: 4px 12px;
border: 1px solid #cfd8dc;
border-radius: 8px;
}
.orders td {
display: grid;
grid-template-columns: 6em 1fr;
gap: 8px;
padding: 6px 0;
white-space: normal;
}
.orders tr td:last-child {
border-bottom: 0;
}
.orders td::before {
content: attr(data-label);
font-weight: bold;
}
}
table・tbody・tr・td を display: block にすると、表の行と列の並びがなくなり、ふつうのブロックとして上から順に積まれます。tr に枠線と角の丸みを付けて、1行を1枚のカードに見せます。
td はさらに display: grid にして、左に6文字分の列名、右に値を並べます。もとの CSS でセルの下に付けている線は、カードの中の区切り線になります。カードの最後のセルだけは、カードの枠線のすぐ上に線が二重に見えないように、border-bottom: 0 で線を消しています。
列名は td::before の content: attr(data-label) で出しています。MDN の attr() のページにあるとおり、型を指定しない attr() は、属性の値をそのまま文字列として返します。検証環境では、::before で出した列名がグリッドの左の列に、セルの文字が右の列に入りました(下の画像)。
見出しの行(thead)は、画面からは見えなくしますが、display: none にはしません。理由はあとの節で書きます。
横360pxの画面では、ページの横幅が360pxに収まり、横にスクロールしなくなりました。1枚目のカードの大きさは328×255pxです。商品名のような長い値は、white-space: normal で右の列の中で折り返されます。横800pxの画面では、メディアクエリの条件に当てはまらないので、もとの表のまま(幅680.2px)でした。

caption も block にしないと、表の名前が縦1列になる
上の CSS で caption を display: block の対象に入れているのは、入れないと表の名前が崩れるからです。caption の指定だけを除いて横360pxで開くと、caption は display: table-caption のまま残り、幅16px・高さ120pxの箱になりました。「注文の一覧」の5文字が、1文字ずつ縦に並びます。

caption も display: block にすると、幅328px・高さ24pxになり、カードの上に1行で出ました。表に caption を付けていない場合は、この指定はなくてもかまいません。
見出しの行は display: none にせず、見えないようにだけする
カードには ::before で列名を出すので、見出しの行は画面には要りません。ただし、display: none で消すと、アクセシビリティツリーから見出しのセルがなくなります。検証環境で、横360pxの画面のアクセシビリティツリーを比べました。
上の CSS(thead を大きさ1pxにして切り取る書き方)では、display: block にしたあとも、表は table、行は row、見出しのセルは columnheader として残りました。
- table "注文の一覧":
- caption: 注文の一覧
- rowgroup:
- row "注文番号 注文日 商品 数量 金額 状態":
- columnheader "注文番号"
- columnheader "注文日"
...
- rowgroup:
- row "注文番号 A-1001 注文日 2026-11-01 商品 ステンレスの保温マグ(350ml) 数量 2 金額 4,180円 状態 発送済み":
- cell "注文番号 A-1001"
- cell "注文日 2026-11-01"
...
thead だけを display: none に変えると、見出しの行がまるごとなくなり、rowgroup のすぐ下にデータの行が来ました。表としての役割(table・row・cell)は残りますが、columnheader は1つもありません。
- table "注文の一覧":
- caption: 注文の一覧
- rowgroup:
- row "注文番号 A-1001 注文日 2026-11-01 商品 ステンレスの保温マグ(350ml) 数量 2 金額 4,180円 状態 発送済み":
- cell "注文番号 A-1001"
...
セルの名前に列名を含めたくないときは、content に / "" を付ける
上のツリーを見ると、アクセシビリティツリーでのセルの名前(読み上げソフトに渡る名前)が「注文番号 A-1001」のように、::before の列名と値をつなげたものになっています。見出しのセル(columnheader)が残っているので、列名がツリーの中に2回出てくることになります。
content には、スラッシュ(/)のあとに代替テキストを書けます。MDN の content のページでは、代替テキストはスクリーンリーダーによる音声出力のためのもので、ブラウザーのアクセシビリティツリーに公開される、と説明されています。代替テキストを空の文字列にすると、列名は画面にだけ出ます。
.orders td::before {
content: attr(data-label) / "";
font-weight: bold;
}
検証環境で試したところ、セルの名前は「A-1001」「2026-11-01」のように値だけになり、columnheader はそのまま残りました。横360pxの画面のスクリーンショットは、/ "" を付ける前と画素まで同じでした。
MDN のブラウザー互換性データ(@mdn/browser-compat-data 8.1.8)では、content の代替テキストは Chrome 77、Edge 79、Firefox 128、Safari 17.4(iOS も17.4)から対応しています。
同じデータで、この記事で使ったほかの機能を見ると、content の中の attr() は Chrome 2、Edge 12、Firefox 1、Safari 3.1 から対応しています。ベンダープレフィックス(-webkit-)の付かない clip-path は Chrome 55、Edge 79、Firefox 3.5、Safari 9.1(iOS は9.3)から対応していて、inset() などの基本図形は、Firefox では54から使えます。





