3 列の比べる表を記事に載せたあと、スマホで読み返していたときのことです。画面の幅に収まらず、横にスクロールしないと「後」の列が見えないうえ、文字も細かく折り返されて、どの数字がどの項目のものかが分かりにくくなっていました。そこで、画面の幅が 600px 以下のときだけ、表の 1 行を 1 枚のカードにして、セルごとに見出しの文字を添える形に変えました。
記事の HTML はそのままで、表示のときに PHP で表に目じるしの class と見出しの文字を付け、CSS で並べ替えます。2 列の表は、スマホでも左右を比べやすいので、そのままにしています。
できあがりの形
PC の幅では、ふだんの表のままです。スマホの幅では、1 行が白い角丸の枠になり、各セルの左に、その列の見出し(th の文字)が出ます。
| 画面の幅 | 3 列以上の表の見え方 |
|---|---|
| 601px 以上 | ふだんの表のまま |
| 600px 以下 | 1 行を 1 枚のカードにして、セルごとに「見出し|内容」の 2 段に並べる。見出しの行は画面から消す |
ポイント
- 記事の本文(データベースの内容)は書き換えない。表示のときにだけ class と data-label を付ける
- カードにするのは 3 列以上の表だけ。2 列の表と、セルを結合した表はそのまま
- 見出しの文字は CSS の
attr(data-label)で出すので、列の名前を CSS に書かなくてよい
PHP:3 列以上の表に class と data-label を付ける
the_content のフィルターで、本文の中の表を 1 つずつ見ます。見出しの行(thead の行、なければセルが全部 th の 1 行目)の文字を読み、3 列以上なら、表に my-cards の class を、各セルに data-label(その列の見出しの文字)を付けます。子テーマの functions.php に書きます。
<?php
/**
* 3 列以上の表に class と data-label を付ける(スマホで行ごとのカードにするため)
*/
add_filter( 'the_content', 'my_table_cards', 20 );
function my_table_cards( $content ) {
if ( is_admin() || is_feed() || stripos( $content, '<table' ) === false ) {
return $content;
}
return preg_replace_callback( '#<table\b[^>]*>.*?</table>#is', 'my_table_cards_one', $content );
}
function my_table_cards_one( $m ) {
$html = $m[0];
// 表の中に表がある・もう付けてある・付けたくない(no-cards)ものは、そのまま
if ( substr_count( strtolower( $html ), '<table' ) > 1
|| preg_match( '#^<table\b[^>]*\bclass="[^"]*\b(my-cards|no-cards)\b#i', $html ) ) {
return $html;
}
// 結合したセルがあると、列と見出しの対応がずれるので付けない
if ( preg_match( '#\b(colspan|rowspan)\s*=\s*["\']?\s*([2-9]|\d{2,})#i', $html ) ) {
return $html;
}
$doc = new DOMDocument();
$prev = libxml_use_internal_errors( true );
$ok = $doc->loadHTML( '<?xml encoding="utf-8"?><div>' . $html . '</div>', LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD );
libxml_clear_errors();
libxml_use_internal_errors( $prev );
$table = $ok ? $doc->getElementsByTagName( 'table' )->item( 0 ) : null;
if ( ! $table ) {
return $html;
}
// 見出しの行:thead の行。なければ「セルが全部 th の、最初の行」
$rows = $table->getElementsByTagName( 'tr' );
$thead = $table->getElementsByTagName( 'thead' )->item( 0 );
$head = null;
if ( $thead ) {
$head = $thead->getElementsByTagName( 'tr' )->item( 0 );
} elseif ( $rows->length > 0 ) {
$first = $rows->item( 0 );
$cells = my_table_cells( $first );
$head = $first;
foreach ( $cells as $c ) {
if ( strtolower( $c->nodeName ) !== 'th' ) {
$head = null; // 1 行目に td がある=見出しの行が分からない
}
}
}
if ( ! $head ) {
return $html;
}
$labels = array();
foreach ( my_table_cells( $head ) as $c ) {
$labels[] = trim( preg_replace( '/\s+/u', ' ', $c->textContent ) );
}
if ( count( $labels ) < 3 ) {
return $html; // 2 列までの表は、スマホでもそのまま
}
foreach ( $rows as $tr ) {
if ( $tr === $head ) {
continue;
}
foreach ( my_table_cells( $tr ) as $i => $c ) {
if ( ! isset( $labels[ $i ] ) ) {
continue;
}
$c->setAttribute( 'data-label', $labels[ $i ] );
// セルの中身を 1 つの div にまとめる(リンクなどが混ざっても、見出しの右に 1 かたまりで並ぶように)
$val = $doc->createElement( 'div' );
$val->setAttribute( 'class', 'my-cards-val' );
while ( $c->firstChild ) {
$val->appendChild( $c->firstChild );
}
$c->appendChild( $val );
}
}
if ( ! $thead ) {
$head->setAttribute( 'class', trim( $head->getAttribute( 'class' ) . ' my-cards-head' ) );
}
$table->setAttribute( 'class', trim( $table->getAttribute( 'class' ) . ' my-cards' ) );
return $doc->saveHTML( $table );
}
function my_table_cells( $tr ) {
$cells = array();
foreach ( $tr->childNodes as $n ) {
if ( $n->nodeType === XML_ELEMENT_NODE && in_array( strtolower( $n->nodeName ), array( 'td', 'th' ), true ) ) {
$cells[] = $n;
}
}
return $cells;
}
セルの内容を div class="my-cards-val" にまとめているのは、次の CSS でセルを grid(格子状のレイアウト)にするためです。grid では、セルの中の文字とリンクが別々の部品として並べられるので、まとめないと「詳しくはこちらを見てください」のような文が 3 つに割れて、リンクだけが見出しの下に回ってしまいます。作業環境のスマホで、まとめた形とまとめない形を並べて確認、まとめない形では実際に割れて表示されました。
優先度を 20 にしているのは、段落の自動整形(wpautop・優先度 10)とショートコード(優先度 11)のあとに動かすためです。ショートコードで出した表も、ここで対象になります。
CSS:600px 以下で行ごとのカードにする
table・tr・td を block にして表の並びをやめ、tr を枠のあるカードに、td を「見出し 5.5em|内容」の 2 列の grid にします。見出しの行は、display:none ではなく画面の外に小さく置いて、読み上げのソフトには残しています。
/* スマホのときだけ、3 列以上の表を行ごとのカードにする */
@media (max-width: 600px) {
table.my-cards,
table.my-cards tbody,
table.my-cards tr,
table.my-cards td,
table.my-cards tbody th {
display: block;
width: 100%;
box-sizing: border-box;
}
table.my-cards {
border: 0;
background: transparent;
}
/* 見出しの行は、画面からは消して読み上げには残す */
table.my-cards thead,
table.my-cards .my-cards-head {
position: absolute;
width: 1px;
height: 1px;
overflow: hidden;
clip: rect(0 0 0 0);
white-space: nowrap;
}
table.my-cards tr {
background: #fff;
border: 1px solid #dcdcd8;
border-radius: 12px;
margin: 0 0 12px;
padding: 6px 14px;
box-shadow: 0 1px 2px rgba(0, 0, 0, .04);
}
table.my-cards td,
table.my-cards tbody th {
display: grid;
grid-template-columns: 5.5em 1fr;
gap: 10px;
border: 0;
border-bottom: 1px dashed #dcdcd8;
padding: 8px 0;
text-align: left;
font-weight: normal;
background: transparent;
}
table.my-cards tr > :last-child {
border-bottom: 0;
}
table.my-cards [data-label]::before {
content: attr(data-label);
font-weight: 700;
font-size: 13px;
color: #0f6e5c;
padding-top: 2px;
}
}
色(#dcdcd8・#0f6e5c)は、テーマに合わせて替えてください。見出しの幅 5.5em は、全角 5 文字くらいの見出しが 1 行に収まる幅です。長い見出しが多い表では、6.5em くらいに広げると折り返しが減ります。box-sizing: border-box は、枠の内側の余白を幅に含めるためのものです。これがないと、tr の幅 100% に余白と枠線が足されて、画面から横にはみ出します(作業環境で、外したときに幅 360px の画面で 374px になりました)。
作業環境で試した結果
作業環境(WordPress 7.1.3・PHP 8.3)で、フィルターの関数を php のコマンドから、いろいろな形の表に通して、出てきた HTML を見ました。
| 通した表 | 結果 |
|---|---|
| thead のある 3 列の表 | table に class=”my-cards”、各 td に data-label=”項目” などが付いた。セルの中の & や <b> の書き方、リンクはそのまま |
| thead がなく、1 行目が th の 3 列の表 | 1 行目の th を見出しとして使い、その行に my-cards-head の class が付いた(スマホでは消える) |
| 2 列の表 | 何も付かない(そのまま) |
| colspan=”2″ のある表 | 何も付かない(列と見出しの対応がずれるため、付けない側に倒す) |
| rowspan=”2″ のある表 | 何も付かない(同じ理由) |
| 1 行目に td がある表(見出しの行がない) | 何も付かない |
| class=”no-cards” を付けた表 | 何も付かない(カードにしたくない表はこの class で外せる) |
| 行の頭が th の表 | 行の頭の th にも data-label が付き、カードの 1 段目になった |
| 同じ本文を 2 回通す | 2 回目は何も変わらない(my-cards があればそのまま) |
| the_content を通した本文 | 段落の自動整形のあとの表にも、同じように付いた |
スマホの実機(Android の Chrome・幅 360px)でも開き、3 列の表が行ごとのカードになり、2 列の表はふだんの表のまま表示されること、横のはみ出しがないことを確認しました。
気をつけること
- 結合したセル(colspan・rowspan)のある表は、どのセルがどの見出しの下かを正しく決められないので、カードにしていません。スマホでも読みやすくしたいときは、結合をやめるか、表を分けてください。
- 表の中に表がある本文も、そのままにしています。
- ページを丸ごとキャッシュする仕組みを使っているときは、設定したあとにキャッシュを消してください。古い HTML のままだと、data-label がなく見出しが出ません。
- 表をスクロールさせる囲み(overflow-x: auto の div など)をテーマや表のプラグインが付けている場合、カードにしたあとは要らなくなります。カードの右側が切れて見えるときは、その囲みの CSS を 600px 以下で外してください。
まとめ
横に長い表は、スマホでは行ごとのカードにすると、見出しと内容が隣り合って読みやすくなります。PHP の the_content フィルターで 3 列以上の表にだけ class と data-label を付け、CSS の @media (max-width:600px) と attr(data-label) で並べ替えれば、記事の HTML を 1 つずつ直す手間がかかりません。結合したセルのある表や 2 列の表は、付けない側に倒しておくと、崩れる心配がありません。

