ページネーションを作る

記事が増えてくると、すべての記事を1ページに表示するのは大変です。今回はARTICLESにページネーションを追加し、記事一覧を複数のページに分けて表示できるようにします。

🎯 目的

記事が増えても、一覧ページを見やすく表示できるようにすることが今回の目的です。

現在のページ番号や全ページ数を使って、ページを切り替える仕組みをPHPで作ります。

今回やること

  1. 表示するページ番号の範囲を決める
  2. ページ番号を繰り返し表示する
  3. 「前」「次」のリンクを表示する
現在のページ
↓
表示するページ番号を計算
↓
ページ番号を表示
↓
前・次へ移動

STEP 1|表示するページ番号の範囲を決める

まず、現在のページを基準にして、どのページ番号を表示するのかを計算します。 今回は最大3個のページ番号を表示します。

<?php

$startPage = max(1, $page - 1);
$endPage = min($totalPages, $startPage + 2);

$startPage = max(1, $endPage - 2);

?>
📘 PHPを読む

$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; ?>
📘 PHPを読む

for = 同じ処理を繰り返すためのPHPの構文
$i = 現在処理しているページ番号
$i++ = $iを1増やす
if = 条件によって処理を分ける
=== = 値と型が同じか厳密に比較する
urlencode() = 値をURLで安全に扱える形へ変換する

→ PHPでページ番号を1つずつ調べ、現在のページなら現在ページとして表示し、 それ以外ならリンクとして表示しています。
📘 HTMLを読む

<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; ?>
📘 PHPを読む

if = 条件に合った場合だけ処理する
$startPage > 1 = 1ページ目より後ろか確認する
$endPage < $totalPages = 最後のページより前か確認する
$startPage - 1 = 前のページ番号
$endPage + 1 = 次のページ番号

→ PHPで現在位置を確認し、必要な場合だけ「前」と「次」のリンクを表示しています。
📘 HTMLを読む

<a href="..."> = 指定したURLへ移動するリンク

→ HTMLでは「前」「次」をクリックできるリンクとして表示しています。

📘 前の記事とのつながり

024|TOPの検索をARTICLESとCOLUMNSの横断検索にする
ARTICLESとCOLUMNSを検索できるようにしました。

今回
記事が増えても一覧を見やすくできるよう、ページネーションを追加しました。

→ 検索できるようになったあと、記事数が増えることを考えて一覧表示も整理しています。

📘 処理の流れを読む

入力:現在ページと全ページ数
↓
処理:表示するページ番号を計算し、条件に応じてリンクを作る
↓
出力:「前・1・2・3・次」のページネーション

→ 「入力 → 処理 → 出力」で整理すると、PHPの処理全体が見えやすくなります。

📝 今回の忘備録

ページネーションでは、現在ページと全ページ数を使って、 表示するページ番号を計算しています。

if による条件分岐と、for による繰り返しが、 実際のWebページの動きに使われています。

コードを見るときは、1行ずつ暗記するのではなく、 「何が入力され、何を判断し、何が出力されるのか」を追うことが大切です。

この先やること

タグ: PHP / HTML / ページネーション / 条件分岐 / 繰り返し / Web制作