CSSで、横に長い表をスマホではカード型に並べ替える方法

​​CSS​HTML,Playwright,アクセシビリティ

注文履歴や料金の一覧のような列の多い表は、スマートフォンの画面では横にはみ出し、ページごと横にスクロールしてしまいます。表をレスポンシブにするには、画面が狭いときだけ 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" を付けています。

html
<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 は、セルの文字を折り返さないための指定です。

css
.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になりました。右側の「数量」「金額」「状態」の列は、横にスクロールしないと見えません。

横360pxの画面で表示した表。注文番号・注文日・商品の3列だけが見え、商品の列は途中で切れている。表の名前の「注文の一覧」も、表の幅の真ん中に置かれるため、途中で切れている
横360pxの画面で、カード型の CSS を付けずに表示したところ

画面が狭いときだけ、行をカードにする

横600px以下の画面で、表をカードの形に変える CSS です。

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)でした。

横360pxの画面で表示した、カード型の表。いちばん上に「注文の一覧」と太字で出て、その下に角の丸い枠のカードが3枚縦に並んでいる。各カードには、左に太字の「注文番号」「注文日」「商品」「数量」「金額」「状態」、右にそれぞれの値が1行ずつ並び、長い商品名は右側の中で2行に折り返されている
横360pxの画面で、上の CSS を付けて表示したところ

caption も block にしないと、表の名前が縦1列になる

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

横360pxの画面で、caption を block にしなかったときの表示。表の名前の「注文の一覧」が、左端に1文字ずつ縦に並んでいる。その下には、1枚目のカードの上の部分が見えている
caption だけを display: block にしなかったときの、ページの上の部分

caption も display: block にすると、幅328px・高さ24pxになり、カードの上に1行で出ました。表に caption を付けていない場合は、この指定はなくてもかまいません。

見出しの行は display: none にせず、見えないようにだけする

カードには ::before で列名を出すので、見出しの行は画面には要りません。ただし、display: none で消すと、アクセシビリティツリーから見出しのセルがなくなります。検証環境で、横360pxの画面のアクセシビリティツリーを比べました。

上の CSS(thead を大きさ1pxにして切り取る書き方)では、display: block にしたあとも、表は table、行は row、見出しのセルは columnheader として残りました。

text
- 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つもありません。

text
- 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 のページでは、代替テキストはスクリーンリーダーによる音声出力のためのもので、ブラウザーのアクセシビリティツリーに公開される、と説明されています。代替テキストを空の文字列にすると、列名は画面にだけ出ます。

css
.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から使えます。

​Posted by 86