スマホのときだけ、3 列以上の表を行ごとのカードにする

機能追加
広告WordPress・PHP を学べる本

Amazonのアソシエイトとして、WordPress functions.phpは適格販売により収入を得ています。

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 に書きます。

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 ではなく画面の外に小さく置いて、読み上げのソフトには残しています。

style.css
/* スマホのときだけ、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 列の表は、付けない側に倒しておくと、崩れる心配がありません。

SiteBeacon(サイトビーコン)

サイトが止まったら、すぐに気づける。

ホームページを 5 分ごとにチェックして、止まったとき・エラーが出たとき・SSL やドメインの期限が近いときに、メールでお知らせします。2 サイトまでは、ずっと無料で使えます。

SiteBeacon を見る サイトを直す相談をする

監視で気づいたあとの直す作業も、同じ担当がお受けします。