記事を10件ずつ表示し、次のページへ進む
12本の記事を10件と2件に分け、最後には次へ進むリンクを出さない一覧を作ります。
目次
記事が増えたら、一度に全部を表示せず、10件ずつ読めるようにできます。今回はページ番号の代わりに「次の10件」というリンクを作ります。
先に用意するもの
写真付き一覧のガイドの「練習用サイトを準備する」まで済ませてください。同じダウンロード教材「週末ノート」を使います。EmDash 1.4.0、Astro 7.4.5、Node.js 24.22.1が対象です。実行確認はmacOSで行いました。Windows向けの入力例はコマンドプロンプト用で、Windows実機では未確認です。
以下のファイル名は、特に断りがなければ教材の weekend-note フォルダーからの場所です。ファイルの内容はVS Codeで編集し、指定された名前で保存します。コマンドはファイルに保存せず、コマンド入力画面へ貼り付けて実行します。どちらも、囲みの前にある説明で作業する場所を確認してください。開発サーバーは weekend-note のコマンド入力画面で npm run dev を実行しておきます。
起動に使った画面は開いたままにします。このあとのコマンドは、別の入力画面で実行します。VS Code左側のファイル一覧で weekend-note フォルダーを右クリックし、**Open in Integrated Terminal(統合ターミナルで開く)**を選ぶと、そのフォルダーを作業場所にした画面を開けます。Windowsでは、パソコンの準備で選んだコマンドプロンプトを使います。
1. ページ送りのコードを用意する
src/pages/paged.astro がこの実習のファイルです。全体は次のとおりです。
---
import { getEmDashCollection } from 'emdash';
import Layout from '../layouts/Layout.astro';
const cursor = Astro.url.searchParams.get('cursor') ?? undefined;
const { entries, nextCursor, error } = await getEmDashCollection('posts', {
limit: 10, cursor, orderBy: { published_at: 'desc' },
});
if (error) return new Response('記事を読み込めませんでした。', { status: 500 });
---
<Layout title="10件ずつ読む"><h1>10件ずつ読む</h1>
<ul>{entries.map(post => <li><a href={`/posts/${post.id}/`}>{post.data.title}</a></li>)}</ul>
<nav aria-label="ページ送り"><a href="/paged/">最初に戻る</a>
{nextCursor && <a rel="next" href={`/paged/?cursor=${encodeURIComponent(nextCursor)}`}>次の10件</a>}</nav>
</Layout>cursor(カーソル)は、続きの開始位置を示す文字列です。1ページ目では指定せず、EmDashから返された nextCursor を次のURLへ渡します。読者や制作者が、この文字列の中身を計算する必要はありません。
encodeURIComponent は、受け取った文字列をURLに入れられる形にします。nextCursor && ... の条件があるため、続きがなければ「次の10件」を表示しません。
2. 10件と2件を確認する
http://127.0.0.1:4350/paged/ を開きます。初期データには公開記事が12本あるので、最初は10本です。「次の10件」を押すと残りの2本が出ます。2ページ目では「次の10件」がなくなり、「最初に戻る」は残ります。
最初の10本と次の2本のタイトルを見比べ、同じ記事が二重に出ていないか確かめます。検証では12本すべてが1回ずつ表示されました。追加の記事を公開している場合は、その分だけ件数が変わります。
3. 件数を変えて試す
limit: 10 を limit: 5 に変え、リンクの文字も「次の5件」に変えて保存します。12本なら5件、5件、2件になります。確認後は両方を10へ戻してください。件数とリンクの言葉は一緒に変更します。
URLの cursor= 以降を自分で書き換える必要はありません。おかしな表示になったら、まず /paged/ を開き直して最初から確認します。記事を途中で公開・削除すると一覧自体が変わるので、重複の確認中はデータを固定します。
「前の10件」を自作するには、過去に使ったカーソルなどの管理も必要です。この例では、ブラウザーの戻る操作と「最初に戻る」を使います。
終了するとき・次回続けるとき
npm run devを実行した画面が入力待ちに戻っていなければ、その画面でControl + Cを押して停止します。入力待ちに戻ったあともサイトが動き続けている場合は、weekend-noteでnpx astro dev stopを実行します。次回は同じフォルダーでnpm run devを実行してください。初期データを入れるseedコマンドを繰り返す必要はありません。