一覧表のデータを一定件数ごとに区切り、ページ番号や移動ボタンで表示内容を切り替えるページネーションの作り方を紹介します。ページを切り替えると、表の見出しはそのままで、表示されるデータだけが更新されます。
今回は、①ページ番号のみ、②前へ・次へ、③最初・最後、④省略表示、⑤全部入りの5種類を紹介します。ページ番号から直接移動する基本形に加え、前後のページへの移動、先頭・最終ページへの移動、途中のページ番号を「…」で省略する表示を確認できます。
⑤全部入りでは、「最初」「前へ」「次へ」「最後」の移動ボタンと省略表示を組み合わせています。現在のページに合わせて表示するページ番号が変わり、先頭ページや最終ページでは移動できない方向のボタンが無効になります。
デモでは100件の社員データを1ページ10件ずつ表示します。ページ番号や移動ボタンをクリックすると、選択したページに対応する10件へ切り替わります。5種類の表示方法を切り替えながら、それぞれの操作と違いを確認できます。
デモ
| 社員番号 | 氏名 | 部署 | 役職 | 出身地 |
|---|
5種類のページネーションを切り替えて操作できます。⑤「全部入り」では、「最初」「前へ」「次へ」「最後」の移動ボタンと、ページ番号の省略表示を組み合わせています。社員一覧は1ページ10件ずつ表示されます。なお、社員データはすべて架空のサンプルです。
コードをコピーして使おう!
掲載している社員データはすべて架空のサンプルです。
① ページ番号のみ
<?php
/* =========================================
CSVの読み込みとページ数の計算
========================================= */
// index.phpと同じ階層のCSVファイルを読み込みます。
$csv_file = 'data.csv';
// 1ページに表示する件数です。10を変更すると表示件数が変わります。
$per_page = 10;
// URLの?page=2などから現在のページを取得します。
$page = filter_input(INPUT_GET, 'page', FILTER_VALIDATE_INT);
if ($page === false || $page === null || $page < 1) {
$page = 1;
}
// CSVの見出しを除いた社員データを読み込みます。
$employees = [];
if (is_readable($csv_file) && ($handle = fopen($csv_file, 'r')) !== false) {
fgetcsv($handle);
while (($row = fgetcsv($handle)) !== false) {
if (count($row) >= 5) {
$employees[] = $row;
}
}
fclose($handle);
}
// 総件数と総ページ数を計算します。
$total_count = count($employees);
$total_pages = (int)ceil($total_count / $per_page);
if ($total_pages > 0 && $page > $total_pages) {
$page = $total_pages;
}
// 現在のページの社員データだけを取り出します。
$offset = ($page - 1) * $per_page;
$page_employees = array_slice($employees, $offset, $per_page);
// 全ページの番号を表示します。
$visible_pages = $total_pages > 0 ? range(1, $total_pages) : [];
?>
<!DOCTYPE html>
<html lang="ja">
<head>
<!-- 文字コードをUTF-8に設定 -->
<meta charset="UTF-8">
<!-- スマートフォンの画面幅に対応 -->
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- ページタイトル -->
<title>CSVを使ったページネーション</title>
<!-- 外部CSSを読み込む -->
<link rel="stylesheet" href="style.css">
</head>
<body>
<div class="csv-pagination_wrap">
<h1 class="csv-pagination_title">社員一覧</h1>
<!-- 画面幅が狭い場合はテーブルを横スクロール -->
<div class="csv-pagination_table-wrap">
<table class="csv-pagination_table">
<thead>
<tr>
<th scope="col">社員番号</th>
<th scope="col">氏名</th>
<th scope="col">部署</th>
<th scope="col">役職</th>
<th scope="col">出身地</th>
</tr>
</thead>
<tbody>
<!-- 現在のページに該当する社員データを表示 -->
<?php foreach ($page_employees as $employee): ?>
<tr>
<td><?= htmlspecialchars($employee[0], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[1], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[2], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[3], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[4], ENT_QUOTES, 'UTF-8') ?></td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
</div>
<!-- ページ移動用のリンク -->
<nav class="csv-pagination_nav" aria-label="ページネーション">
<?php foreach ($visible_pages as $number): ?>
<?php if ($number === 'dots'): ?>
<span class="csv-pagination_ellipsis" aria-hidden="true">…</span>
<?php elseif ($number === $page): ?>
<span class="csv-pagination_current" aria-current="page"><?= $number ?></span>
<?php else: ?>
<a class="csv-pagination_page" href="?page=<?= $number ?>"><?= $number ?></a>
<?php endif; ?>
<?php endforeach; ?>
</nav>
</div>
</body>
</html>
② 前へ・次へ
<?php
/* =========================================
CSVの読み込みとページ数の計算
========================================= */
// index.phpと同じ階層のCSVファイルを読み込みます。
$csv_file = 'data.csv';
// 1ページに表示する件数です。10を変更すると表示件数が変わります。
$per_page = 10;
// URLの?page=2などから現在のページを取得します。
$page = filter_input(INPUT_GET, 'page', FILTER_VALIDATE_INT);
if ($page === false || $page === null || $page < 1) {
$page = 1;
}
// CSVの見出しを除いた社員データを読み込みます。
$employees = [];
if (is_readable($csv_file) && ($handle = fopen($csv_file, 'r')) !== false) {
fgetcsv($handle);
while (($row = fgetcsv($handle)) !== false) {
if (count($row) >= 5) {
$employees[] = $row;
}
}
fclose($handle);
}
// 総件数と総ページ数を計算します。
$total_count = count($employees);
$total_pages = (int)ceil($total_count / $per_page);
if ($total_pages > 0 && $page > $total_pages) {
$page = $total_pages;
}
// 現在のページの社員データだけを取り出します。
$offset = ($page - 1) * $per_page;
$page_employees = array_slice($employees, $offset, $per_page);
// 全ページの番号を表示します。
$visible_pages = $total_pages > 0 ? range(1, $total_pages) : [];
?>
<!DOCTYPE html>
<html lang="ja">
<head>
<!-- 文字コードをUTF-8に設定 -->
<meta charset="UTF-8">
<!-- スマートフォンの画面幅に対応 -->
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- ページタイトル -->
<title>CSVを使ったページネーション</title>
<!-- 外部CSSを読み込む -->
<link rel="stylesheet" href="style.css">
</head>
<body>
<div class="csv-pagination_wrap">
<h1 class="csv-pagination_title">社員一覧</h1>
<!-- 画面幅が狭い場合はテーブルを横スクロール -->
<div class="csv-pagination_table-wrap">
<table class="csv-pagination_table">
<thead>
<tr>
<th scope="col">社員番号</th>
<th scope="col">氏名</th>
<th scope="col">部署</th>
<th scope="col">役職</th>
<th scope="col">出身地</th>
</tr>
</thead>
<tbody>
<!-- 現在のページに該当する社員データを表示 -->
<?php foreach ($page_employees as $employee): ?>
<tr>
<td><?= htmlspecialchars($employee[0], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[1], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[2], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[3], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[4], ENT_QUOTES, 'UTF-8') ?></td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
</div>
<!-- ページ移動用のリンク -->
<nav class="csv-pagination_nav" aria-label="ページネーション">
<?php if ($page > 1): ?>
<a class="csv-pagination_page" href="?page=<?= $page - 1 ?>">前へ</a>
<?php else: ?>
<span class="csv-pagination_disabled" aria-disabled="true">前へ</span>
<?php endif; ?>
<?php foreach ($visible_pages as $number): ?>
<?php if ($number === 'dots'): ?>
<span class="csv-pagination_ellipsis" aria-hidden="true">…</span>
<?php elseif ($number === $page): ?>
<span class="csv-pagination_current" aria-current="page"><?= $number ?></span>
<?php else: ?>
<a class="csv-pagination_page" href="?page=<?= $number ?>"><?= $number ?></a>
<?php endif; ?>
<?php endforeach; ?>
<?php if ($page < $total_pages): ?>
<a class="csv-pagination_page" href="?page=<?= $page + 1 ?>">次へ</a>
<?php else: ?>
<span class="csv-pagination_disabled" aria-disabled="true">次へ</span>
<?php endif; ?>
</nav>
</div>
</body>
</html>
③ 最初・最後
<?php
/* =========================================
CSVの読み込みとページ数の計算
========================================= */
// index.phpと同じ階層のCSVファイルを読み込みます。
$csv_file = 'data.csv';
// 1ページに表示する件数です。10を変更すると表示件数が変わります。
$per_page = 10;
// URLの?page=2などから現在のページを取得します。
$page = filter_input(INPUT_GET, 'page', FILTER_VALIDATE_INT);
if ($page === false || $page === null || $page < 1) {
$page = 1;
}
// CSVの見出しを除いた社員データを読み込みます。
$employees = [];
if (is_readable($csv_file) && ($handle = fopen($csv_file, 'r')) !== false) {
fgetcsv($handle);
while (($row = fgetcsv($handle)) !== false) {
if (count($row) >= 5) {
$employees[] = $row;
}
}
fclose($handle);
}
// 総件数と総ページ数を計算します。
$total_count = count($employees);
$total_pages = (int)ceil($total_count / $per_page);
if ($total_pages > 0 && $page > $total_pages) {
$page = $total_pages;
}
// 現在のページの社員データだけを取り出します。
$offset = ($page - 1) * $per_page;
$page_employees = array_slice($employees, $offset, $per_page);
// 全ページの番号を表示します。
$visible_pages = $total_pages > 0 ? range(1, $total_pages) : [];
?>
<!DOCTYPE html>
<html lang="ja">
<head>
<!-- 文字コードをUTF-8に設定 -->
<meta charset="UTF-8">
<!-- スマートフォンの画面幅に対応 -->
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- ページタイトル -->
<title>CSVを使ったページネーション</title>
<!-- 外部CSSを読み込む -->
<link rel="stylesheet" href="style.css">
</head>
<body>
<div class="csv-pagination_wrap">
<h1 class="csv-pagination_title">社員一覧</h1>
<!-- 画面幅が狭い場合はテーブルを横スクロール -->
<div class="csv-pagination_table-wrap">
<table class="csv-pagination_table">
<thead>
<tr>
<th scope="col">社員番号</th>
<th scope="col">氏名</th>
<th scope="col">部署</th>
<th scope="col">役職</th>
<th scope="col">出身地</th>
</tr>
</thead>
<tbody>
<!-- 現在のページに該当する社員データを表示 -->
<?php foreach ($page_employees as $employee): ?>
<tr>
<td><?= htmlspecialchars($employee[0], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[1], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[2], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[3], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[4], ENT_QUOTES, 'UTF-8') ?></td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
</div>
<!-- ページ移動用のリンク -->
<nav class="csv-pagination_nav" aria-label="ページネーション">
<?php if ($page > 1): ?>
<a class="csv-pagination_page" href="?page=1">最初</a>
<?php else: ?>
<span class="csv-pagination_disabled" aria-disabled="true">最初</span>
<?php endif; ?>
<?php foreach ($visible_pages as $number): ?>
<?php if ($number === 'dots'): ?>
<span class="csv-pagination_ellipsis" aria-hidden="true">…</span>
<?php elseif ($number === $page): ?>
<span class="csv-pagination_current" aria-current="page"><?= $number ?></span>
<?php else: ?>
<a class="csv-pagination_page" href="?page=<?= $number ?>"><?= $number ?></a>
<?php endif; ?>
<?php endforeach; ?>
<?php if ($page < $total_pages): ?>
<a class="csv-pagination_page" href="?page=<?= $total_pages ?>">最後</a>
<?php else: ?>
<span class="csv-pagination_disabled" aria-disabled="true">最後</span>
<?php endif; ?>
</nav>
</div>
</body>
</html>
④ 省略表示
<?php
/* =========================================
CSVの読み込みとページ数の計算
========================================= */
// index.phpと同じ階層のCSVファイルを読み込みます。
$csv_file = 'data.csv';
// 1ページに表示する件数です。10を変更すると表示件数が変わります。
$per_page = 10;
// URLの?page=2などから現在のページを取得します。
$page = filter_input(INPUT_GET, 'page', FILTER_VALIDATE_INT);
if ($page === false || $page === null || $page < 1) {
$page = 1;
}
// CSVの見出しを除いた社員データを読み込みます。
$employees = [];
if (is_readable($csv_file) && ($handle = fopen($csv_file, 'r')) !== false) {
fgetcsv($handle);
while (($row = fgetcsv($handle)) !== false) {
if (count($row) >= 5) {
$employees[] = $row;
}
}
fclose($handle);
}
// 総件数と総ページ数を計算します。
$total_count = count($employees);
$total_pages = (int)ceil($total_count / $per_page);
if ($total_pages > 0 && $page > $total_pages) {
$page = $total_pages;
}
// 現在のページの社員データだけを取り出します。
$offset = ($page - 1) * $per_page;
$page_employees = array_slice($employees, $offset, $per_page);
// 7ページを超える場合は、現在位置に合わせてページ番号を省略します。
$visible_pages = [];
if ($total_pages <= 7) {
for ($i = 1; $i <= $total_pages; $i++) {
$visible_pages[] = $i;
}
} elseif ($page <= 4) {
$visible_pages = [1, 2, 3, 4, 5, 'dots', $total_pages];
} elseif ($page >= $total_pages - 3) {
$visible_pages = [1, 'dots', $total_pages - 4, $total_pages - 3, $total_pages - 2, $total_pages - 1, $total_pages];
} else {
$visible_pages = [1, 'dots', $page - 1, $page, $page + 1, 'dots', $total_pages];
}
?>
<!DOCTYPE html>
<html lang="ja">
<head>
<!-- 文字コードをUTF-8に設定 -->
<meta charset="UTF-8">
<!-- スマートフォンの画面幅に対応 -->
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- ページタイトル -->
<title>CSVを使ったページネーション</title>
<!-- 外部CSSを読み込む -->
<link rel="stylesheet" href="style.css">
</head>
<body>
<div class="csv-pagination_wrap">
<h1 class="csv-pagination_title">社員一覧</h1>
<!-- 画面幅が狭い場合はテーブルを横スクロール -->
<div class="csv-pagination_table-wrap">
<table class="csv-pagination_table">
<thead>
<tr>
<th scope="col">社員番号</th>
<th scope="col">氏名</th>
<th scope="col">部署</th>
<th scope="col">役職</th>
<th scope="col">出身地</th>
</tr>
</thead>
<tbody>
<!-- 現在のページに該当する社員データを表示 -->
<?php foreach ($page_employees as $employee): ?>
<tr>
<td><?= htmlspecialchars($employee[0], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[1], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[2], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[3], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[4], ENT_QUOTES, 'UTF-8') ?></td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
</div>
<!-- ページ移動用のリンク -->
<nav class="csv-pagination_nav" aria-label="ページネーション">
<?php foreach ($visible_pages as $number): ?>
<?php if ($number === 'dots'): ?>
<span class="csv-pagination_ellipsis" aria-hidden="true">…</span>
<?php elseif ($number === $page): ?>
<span class="csv-pagination_current" aria-current="page"><?= $number ?></span>
<?php else: ?>
<a class="csv-pagination_page" href="?page=<?= $number ?>"><?= $number ?></a>
<?php endif; ?>
<?php endforeach; ?>
</nav>
</div>
</body>
</html>
⑤ 全部入り
<?php
/* =========================================
CSVの読み込みとページ数の計算
========================================= */
// index.phpと同じ階層のCSVファイルを読み込みます。
$csv_file = 'data.csv';
// 1ページに表示する件数です。10を変更すると表示件数が変わります。
$per_page = 10;
// URLの?page=2などから現在のページを取得します。
$page = filter_input(INPUT_GET, 'page', FILTER_VALIDATE_INT);
if ($page === false || $page === null || $page < 1) {
$page = 1;
}
// CSVの見出しを除いた社員データを読み込みます。
$employees = [];
if (is_readable($csv_file) && ($handle = fopen($csv_file, 'r')) !== false) {
fgetcsv($handle);
while (($row = fgetcsv($handle)) !== false) {
if (count($row) >= 5) {
$employees[] = $row;
}
}
fclose($handle);
}
// 総件数と総ページ数を計算します。
$total_count = count($employees);
$total_pages = (int)ceil($total_count / $per_page);
if ($total_pages > 0 && $page > $total_pages) {
$page = $total_pages;
}
// 現在のページの社員データだけを取り出します。
$offset = ($page - 1) * $per_page;
$page_employees = array_slice($employees, $offset, $per_page);
// 7ページを超える場合は、現在位置に合わせてページ番号を省略します。
$visible_pages = [];
if ($total_pages <= 7) {
for ($i = 1; $i <= $total_pages; $i++) {
$visible_pages[] = $i;
}
} elseif ($page <= 4) {
$visible_pages = [1, 2, 3, 4, 5, 'dots', $total_pages];
} elseif ($page >= $total_pages - 3) {
$visible_pages = [1, 'dots', $total_pages - 4, $total_pages - 3, $total_pages - 2, $total_pages - 1, $total_pages];
} else {
$visible_pages = [1, 'dots', $page - 1, $page, $page + 1, 'dots', $total_pages];
}
?>
<!DOCTYPE html>
<html lang="ja">
<head>
<!-- 文字コードをUTF-8に設定 -->
<meta charset="UTF-8">
<!-- スマートフォンの画面幅に対応 -->
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- ページタイトル -->
<title>CSVを使ったページネーション</title>
<!-- 外部CSSを読み込む -->
<link rel="stylesheet" href="style.css">
</head>
<body>
<div class="csv-pagination_wrap">
<h1 class="csv-pagination_title">社員一覧</h1>
<!-- 画面幅が狭い場合はテーブルを横スクロール -->
<div class="csv-pagination_table-wrap">
<table class="csv-pagination_table">
<thead>
<tr>
<th scope="col">社員番号</th>
<th scope="col">氏名</th>
<th scope="col">部署</th>
<th scope="col">役職</th>
<th scope="col">出身地</th>
</tr>
</thead>
<tbody>
<!-- 現在のページに該当する社員データを表示 -->
<?php foreach ($page_employees as $employee): ?>
<tr>
<td><?= htmlspecialchars($employee[0], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[1], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[2], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[3], ENT_QUOTES, 'UTF-8') ?></td>
<td><?= htmlspecialchars($employee[4], ENT_QUOTES, 'UTF-8') ?></td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
</div>
<!-- ページ移動用のリンク -->
<nav class="csv-pagination_nav" aria-label="ページネーション">
<?php if ($page > 1): ?>
<a class="csv-pagination_page" href="?page=1">最初</a>
<?php else: ?>
<span class="csv-pagination_disabled" aria-disabled="true">最初</span>
<?php endif; ?>
<?php if ($page > 1): ?>
<a class="csv-pagination_page" href="?page=<?= $page - 1 ?>">前へ</a>
<?php else: ?>
<span class="csv-pagination_disabled" aria-disabled="true">前へ</span>
<?php endif; ?>
<?php foreach ($visible_pages as $number): ?>
<?php if ($number === 'dots'): ?>
<span class="csv-pagination_ellipsis" aria-hidden="true">…</span>
<?php elseif ($number === $page): ?>
<span class="csv-pagination_current" aria-current="page"><?= $number ?></span>
<?php else: ?>
<a class="csv-pagination_page" href="?page=<?= $number ?>"><?= $number ?></a>
<?php endif; ?>
<?php endforeach; ?>
<?php if ($page < $total_pages): ?>
<a class="csv-pagination_page" href="?page=<?= $page + 1 ?>">次へ</a>
<?php else: ?>
<span class="csv-pagination_disabled" aria-disabled="true">次へ</span>
<?php endif; ?>
<?php if ($page < $total_pages): ?>
<a class="csv-pagination_page" href="?page=<?= $total_pages ?>">最後</a>
<?php else: ?>
<span class="csv-pagination_disabled" aria-disabled="true">最後</span>
<?php endif; ?>
</nav>
</div>
</body>
</html>
コードをコピーする場合 使用するコードのタブを選び、「このタブをコピー」をクリックすると、現在表示中のコードをコピーできます。 サンプル一式を取得する場合 HTML・CSSなどすべてのファイルが必要な場合は、「サンプル一式をダウンロード」をクリックしてください。
Q ダウンロードしたけど、これをネット上で動かすにはどうするの?
Googleアカウントがあれば、InfinityFreeで無料サーバーを作成して、ダウンロードしたサンプルをネット上で動かせます。
InfinityFreeを初めて利用する場合は①から、すでにサーバーを作成している場合は②へ進んでください。
ファイル構成と設置方法
今回のサンプルは、PHP・CSS・CSVの3つのファイルで構成されています。PHPではCSVファイルから社員データを読み込み、現在のページ番号に合わせて表示する10件を取り出します。CSSでは社員一覧のテーブルとページネーションの外観を設定し、CSVには社員番号・氏名・部署・役職・出身地のデータを保存しています。
掲載しているコードは、①ページ番号のみ、②前へ・次へ、③最初・最後、④省略表示、⑤全部入りの5種類です。それぞれ独立したサンプルとして使用でき、ページ移動の仕組みはPHPで処理するため、JavaScriptは必要ありません。
sample/
├── index.php
├── style.css
└── data.csv
各ファイルの役割
index.phpには、CSVの読み込み、ページ番号の取得、総ページ数の計算、社員一覧の表示、ページネーションの生成処理を記述しています。
style.cssでは、社員一覧の横幅・余白・文字色・列幅・枠線や、ページ番号・移動ボタン・省略記号のデザインを設定しています。
data.csvには、社員100件のサンプルデータを保存しています。1行目は項目名で、2行目以降に社員データが記録されています。
設置方法・使い方
使用したい種類の「サンプル一式をダウンロード」をクリックしてZIPファイルを保存し、展開してください。sampleフォルダ内のindex.php・style.css・data.csvを同じ階層に配置します。
このサンプルはPHPを使用するため、PHPが動作するサーバーにアップロードしてアクセスしてください。HTMLファイルとは異なり、index.phpをパソコン上で直接開くだけでは動作しません。
ページを開くと社員一覧が表示され、ページ番号や移動ボタンをクリックすると、選択したページの社員データに切り替わります。
CSVファイルを読み込む仕組み
index.phpでは、$csv_fileに読み込むCSVファイル名を指定しています。今回の設定では、index.phpと同じ階層にあるdata.csvを読み込みます。
fopen()でCSVファイルを開き、fgetcsv()で1行ずつ取得しています。最初の1行は項目名なので読み飛ばし、2行目以降の社員データを$employees配列に保存します。
// index.phpと同じ階層のCSVファイルを読み込みます。
$csv_file = 'data.csv';
// CSVの見出しを除いた社員データを読み込みます。
$employees = [];
if (is_readable($csv_file) && ($handle = fopen($csv_file, 'r')) !== false) {
fgetcsv($handle);
while (($row = fgetcsv($handle)) !== false) {
if (count($row) >= 5) {
$employees[] = $row;
}
}
fclose($handle);
}
is_readable()は、指定したCSVファイルを読み込めるか確認する処理です。fgetcsv()は、カンマで区切られた各項目を配列として取得します。
count($row) >= 5では、今回使用する5項目がそろっている行だけを追加しています。CSVの項目数を変更する場合は、この条件とテーブルの列構成も合わせて変更してください。
CSVの読み込みは、ページを開くたびに実行されます。ページ番号をクリックして別のページへ移動した場合も、PHPがCSVの全件を読み込み、その中から表示対象のデータを取り出します。
JavaScriptを使用する場合と大容量CSVへの対応
今回掲載している5種類のコードには含まれませんが、JavaScriptを使用してCSVファイルを読み込み、ブラウザ上でページネーションを処理する方法もあります。
例えば、社員100件のCSVを最初に一度だけ読み込み、JavaScriptの配列に保存しておけば、2ページ目や3ページ目へ移動するときにCSVを再読み込みする必要はありません。ページ番号に応じて配列から10件ずつ取り出し、テーブルの表示内容だけを切り替えられます。
ただし、数万件・数十万件などの大容量CSVをすべてブラウザに読み込むと、通信量やメモリ使用量が増え、表示が遅くなる場合があります。そのような場合は、PHPなどのサーバー側でデータを処理し、JavaScriptから必要なページのデータだけを取得する方法が適しています。
例えば2ページ目を要求すると、サーバー側から11〜20件目のデータだけをJSON形式で受け取り、テーブルに表示します。CSV全件をブラウザへ送信する必要がなくなります。
なお、サーバー側でも効率よく処理するには、データベースの利用やCSVの行位置を管理する仕組みなどが必要です。今回のPHPコードはページ移動のたびにCSV全件を読み込む方式であり、JavaScriptによるページ切り替えや大容量CSVの部分取得は実装していません。
現在のページ番号を取得する方法
ページ番号は、URLのpageパラメーターで指定します。例えば、index.php?page=2へアクセスすると、2ページ目の社員データが表示されます。
filter_input()でページ番号を整数として取得し、指定がない場合や1未満の値が指定された場合は、1ページ目を表示します。
// URLの?page=2などから現在のページを取得します。
$page = filter_input(INPUT_GET, 'page', FILTER_VALIDATE_INT);
if ($page === false || $page === null || $page < 1) {
$page = 1;
}
$pageには現在のページ番号が入ります。1ページ目なら1、2ページ目なら2です。
URLで存在しないページ番号が指定された場合は、総ページ数を計算した後に最後のページへ調整しています。
1ページに表示する件数を変更する方法
1ページの表示件数は、index.phpの$per_pageで設定しています。初期値は10なので、社員100件を10ページに分けて表示します。
// 1ページに表示する件数です。10を変更すると表示件数が変わります。
$per_page = 10;
例えば20に変更すると、1ページに20件ずつ表示され、社員100件の場合は5ページになります。5に変更すると、1ページ5件で20ページになります。
総ページ数はCSVの件数から自動計算されるため、CSVに社員データを追加・削除した場合も、ページ数を手動で変更する必要はありません。$per_pageには1以上の整数を指定してください。
総ページ数と表示対象を計算する仕組み
count()で社員データの総件数を取得し、ceil()で総ページ数を計算しています。
$offsetは、現在のページで何件目からデータを表示するかを示します。array_slice()を使用して、全社員データから現在のページに必要な件数だけを取り出します。
// 総件数と総ページ数を計算します。
$total_count = count($employees);
$total_pages = (int)ceil($total_count / $per_page);
if ($total_pages > 0 && $page > $total_pages) {
$page = $total_pages;
}
// 現在のページの社員データだけを取り出します。
$offset = ($page - 1) * $per_page;
$page_employees = array_slice($employees, $offset, $per_page);
1ページ10件の場合、1ページ目の$offsetは0、2ページ目は10、3ページ目は20になります。
$page_employeesには、現在表示する社員データだけが入ります。CSV全体のデータは$employeesに保持され、HTMLのテーブルには$page_employeesの内容を表示しています。
5種類のページネーションの違い
①「ページ番号のみ」は、1ページ目から最後のページまでの番号をすべて表示します。
②「前へ・次へ」は、ページ番号の前後に移動ボタンを配置します。
③「最初・最後」は、ページ番号の前後に最初のページと最後のページへ移動するボタンを配置します。
④「省略表示」は、現在のページに合わせて表示する番号を絞り込み、離れたページ番号を「…」で省略します。
⑤「全部入り」は、「最初」「前へ」「次へ」「最後」の移動ボタンと、ページ番号の省略表示を組み合わせています。
5種類ともCSVの読み込み方法と社員データの表示処理は共通で、ページネーションを生成する部分が異なります。
ページ番号をリンクとして表示する仕組み
ページ番号は、href="?page=2"のようにURLへ移動先の番号を指定して表示しています。リンクをクリックするとPHPが再実行され、指定したページの社員データが表示されます。
現在表示しているページは、リンクではなくspan要素で表示し、aria-current="page"を設定しています。
<?php foreach ($visible_pages as $number): ?>
<?php if ($number === 'dots'): ?>
<span class="csv-pagination_ellipsis" aria-hidden="true">…</span>
<?php elseif ($number === $page): ?>
<span class="csv-pagination_current" aria-current="page"><?= $number ?></span>
<?php else: ?>
<a class="csv-pagination_page" href="?page=<?= $number ?>"><?= $number ?></a>
<?php endif; ?>
<?php endforeach; ?>
$visible_pagesには表示対象のページ番号が入ります。④と⑤では省略部分を'dots'で表し、HTMLに出力する際に「…」へ置き換えています。
省略記号はページ移動用のリンクではないため、クリックしても移動しません。現在のページ番号にはcsv-pagination_current、通常のページ番号にはcsv-pagination_pageを使用しています。
CSVの社員データを変更する方法
data.csvには、動作確認用として架空の社員100件のサンプルデータを収録しています。社員一覧の内容を変更する場合は、data.csvを編集します。1行目には項目名を記述し、2行目以降に社員データを追加してください。
今回のCSVは「社員番号・氏名・部署・役職・出身地」の5項目で構成されています。各項目はカンマで区切り、文字コードはUTF-8で保存してください。
社員番号,氏名,部署,役職,出身地
1001,山田 太郎,営業部,主任,東京都
1002,佐藤 花子,営業部,一般,神奈川県
1003,鈴木 一郎,営業部,係長,大阪府
社員データを追加すると、CSVの総件数に応じて総ページ数が自動で変わります。例えば100件から105件に増やした場合、1ページ10件の設定では11ページになります。
氏名や部署などにカンマを含める場合は、その項目をダブルクォーテーションで囲んでください。CSVの列を追加・削除する場合は、index.phpのテーブル見出しとデータ出力部分も変更する必要があります。
テーブルの横幅と列幅を変更する方法
社員一覧の横幅は、style.cssの.csv-pagination_tableで設定しています。初期設定ではwidth: 100%;で利用可能な横幅に合わせ、min-width: 760px;で最小横幅を確保しています。
.csv-pagination_table {
width: 100%;
min-width: 760px;
table-layout: fixed;
border-collapse: collapse;
}
min-widthを大きくすると、テーブルの最小横幅が広がります。列ごとの横幅は、th:nth-child()とtd:nth-child()で調整できます。
例えば、氏名列の横幅を変更する場合は、2列目に指定しているwidthを調整してください。
/* 氏名列の横幅 */
.csv-pagination_table th:nth-child(2),
.csv-pagination_table td:nth-child(2) {
width: 180px;
}
180pxを220pxに変更すると、氏名列を広くできます。列幅を変更した場合は、必要に応じてテーブル全体のmin-widthも調整してください。
ページ番号の大きさと間隔を変更する方法
ページ番号や移動ボタンの大きさは、style.cssの.csv-pagination_pageで調整できます。min-widthは最小横幅、heightは高さ、paddingは内側の余白、border-radiusは角丸です。
ページ番号同士の間隔は、.csv-pagination_navのgapで設定しています。
.csv-pagination_nav {
display: flex;
justify-content: center;
align-items: center;
gap: 8px;
flex-wrap: wrap;
margin-top: 24px;
}
.csv-pagination_page {
min-width: 42px;
height: 42px;
padding: 0 12px;
border-radius: 10px;
}
gap: 8px;を12pxにすると、ページ番号同士の間隔が広がります。min-widthとheightを変更する場合は、現在ページを表示する.csv-pagination_currentや、使用している種類に応じて無効状態のボタンも同じ大きさに調整すると、並びをそろえられます。
レスポンシブ対応について
社員一覧のテーブルは、.csv-pagination_table-wrapにoverflow-x: auto;を指定しています。画面幅が狭く、テーブルが表示領域に収まらない場合は、テーブル部分だけを横スクロールできます。
ページネーションにはflex-wrap: wrap;を指定しているため、ページ番号や移動ボタンが横幅に収まらない場合は折り返して表示されます。スマートフォンでもページ移動の操作を行えます。
/* テーブルが表示領域を超えた場合は横スクロール */
.csv-pagination_table-wrap {
overflow-x: auto;
}
/* ページ番号が収まらない場合は折り返す */
.csv-pagination_nav {
display: flex;
flex-wrap: wrap;
}
/* 画面幅640px以下のスマートフォン対応 */
@media (max-width: 640px) {
.csv-pagination_wrap {
padding: 16px;
}
.csv-pagination_title {
font-size: 24px;
}
}
overflow-x: auto;によって、画面幅が狭い場合でも社員一覧の5列を維持したまま横スクロールできます。flex-wrap: wrap;は、ページ番号を必要に応じて次の行へ折り返す設定です。
@media (max-width: 640px)では、画面幅640px以下のときに全体の内側余白と見出しの文字サイズを小さくしています。640pxを変更すると、スマートフォン向けのスタイルへ切り替わる画面幅を調整できます。
コメント