ページネーションを作る
記事が増えてくると、すべての記事を1ページに表示するのは大変です。今回はARTICLESにページネーションを追加し、記事一覧を複数のページに分けて表示できるようにします。
🎯 目的
記事が増えても、一覧ページを見やすく表示できるようにすることが今回の目的です。
現在のページ番号や全ページ数を使って、ページを切り替える仕組みをPHPで作ります。
今回やること
- 表示するページ番号の範囲を決める
- ページ番号を繰り返し表示する
- 「前」「次」のリンクを表示する
↓
表示するページ番号を計算
↓
ページ番号を表示
↓
前・次へ移動
STEP 1|表示するページ番号の範囲を決める
まず、現在のページを基準にして、どのページ番号を表示するのかを計算します。 今回は最大3個のページ番号を表示します。
<?php
$startPage = max(1, $page - 1);
$endPage = min($totalPages, $startPage + 2);
$startPage = max(1, $endPage - 2);
?>
$startPage = 表示を開始するページ番号$page = 現在表示しているページ番号max() = 複数の値の中から大きい方を返すPHPの関数$page - 1 = 現在ページの1つ前のページ$endPage = 表示を終了するページ番号$totalPages = 全ページ数min() = 複数の値の中から小さい方を返すPHPの関数→ PHPで現在ページと全ページ数を使い、表示するページ番号の範囲を計算しています。
STEP 2|ページ番号を表示する
表示するページ番号は、1個ずつ手書きするのではなく、 PHPの繰り返し処理を使って表示します。
<?php for ($i = $startPage; $i <= $endPage; $i++): ?>
<?php if ($i === $page): ?>
<span
class="current"
aria-current="page"
>
<?= $i ?>
</span>
<?php else: ?>
<a href="/articles.php?project=<?= urlencode($project) ?>&page=<?= $i ?>">
<?= $i ?>
</a>
<?php endif; ?>
<?php endfor; ?>
for = 同じ処理を繰り返すためのPHPの構文$i = 現在処理しているページ番号$i++ = $iを1増やすif = 条件によって処理を分ける=== = 値と型が同じか厳密に比較するurlencode() = 値をURLで安全に扱える形へ変換する→ PHPでページ番号を1つずつ調べ、現在のページなら現在ページとして表示し、 それ以外ならリンクとして表示しています。
<a> = リンクを作るHTML要素href = リンク先のURLを指定する属性<span> = 一部分をまとめるHTML要素aria-current="page" = 現在のページであることを支援技術へ伝える属性→ HTMLでは、クリックできるページ番号と、現在表示しているページ番号を分けて表示しています。
STEP 3|「前」と「次」を表示する
ページ番号だけでなく、前後のページへ移動するリンクも表示します。 ただし、1ページ目では「前」を表示せず、最後のページでは「次」を表示しません。
<?php if ($startPage > 1): ?>
<a href="/articles.php?project=<?= urlencode($project) ?>&page=<?= $startPage - 1 ?>">
前
</a>
<?php endif; ?>
<?php if ($endPage < $totalPages): ?>
<a href="/articles.php?project=<?= urlencode($project) ?>&page=<?= $endPage + 1 ?>">
次
</a>
<?php endif; ?>
if = 条件に合った場合だけ処理する$startPage > 1 = 1ページ目より後ろか確認する$endPage < $totalPages = 最後のページより前か確認する$startPage - 1 = 前のページ番号$endPage + 1 = 次のページ番号→ PHPで現在位置を確認し、必要な場合だけ「前」と「次」のリンクを表示しています。
<a href="..."> = 指定したURLへ移動するリンク→ HTMLでは「前」「次」をクリックできるリンクとして表示しています。
📘 前の記事とのつながり
ARTICLESとCOLUMNSを検索できるようにしました。
今回
記事が増えても一覧を見やすくできるよう、ページネーションを追加しました。
→ 検索できるようになったあと、記事数が増えることを考えて一覧表示も整理しています。
📘 処理の流れを読む
↓
処理:表示するページ番号を計算し、条件に応じてリンクを作る
↓
出力:「前・1・2・3・次」のページネーション
→ 「入力 → 処理 → 出力」で整理すると、PHPの処理全体が見えやすくなります。
📝 今回の忘備録
ページネーションでは、現在ページと全ページ数を使って、 表示するページ番号を計算しています。
if による条件分岐と、for による繰り返しが、
実際のWebページの動きに使われています。
コードを見るときは、1行ずつ暗記するのではなく、 「何が入力され、何を判断し、何が出力されるのか」を追うことが大切です。
この先やること
- ページネーションを共通部品にする
- ARTICLESだけでなくCOLUMNSでも同じ部品を使う