記事一覧と詳細ページを作る

CMSに保存した記事を読み込み、タイトルの一覧と本文のページを作ります。取得失敗と記事がない場合も分けて扱います。

目次

同じ記事を、一覧と詳細で使う

一覧ページと詳細ページには、EmDashに保存した同じ記事を使えます。記事を2回書く必要はありません。一覧ページではタイトルを、詳細ページでは本文を読み込んで表示します。

このガイドは小さなテーマの続きです。LearningLayout.astroがあり、postsにtitleとcontentという欄があること、最初の記事を公開したことを前提にします。対象はEmDash 1.4.0です。

1. 記事一覧を作る

src/pages/practice/posts/index.astroを作ります。次が全体です。

---
import { getEmDashCollection } from "emdash";
import LearningLayout from "../../../layouts/LearningLayout.astro";

const { entries: posts, error } = await getEmDashCollection("posts", {
  orderBy: { published_at: "desc" },
});

if (error) {
  return new Response("記事を読み込めませんでした。", { status: 500 });
}
---

<LearningLayout title="記事一覧">
  <h1>記事一覧</h1>
  {posts.length === 0 ? (
    <p>公開中の記事は、まだありません。</p>
  ) : (
    <ul>
      {posts.map((post) => (
        <li>
          <a href={`/practice/posts/${post.id}/`}>{post.data.title}</a>
        </li>
      ))}
    </ul>
  )}
</LearningLayout>

getEmDashCollection("posts", ...)は、postsという記事の入れ物から一覧を取得する命令です。entries: postsは「受け取った一覧を、このファイルではpostsと呼ぶ」という意味です。

published_atは公開日時、descは新しいものから並べる指定です。標準の公開向け取得では下書きを一覧に含めません。

mapは、記事を1件ずつリンクに変える処理です。post.data.titleはタイトル、post.idはこの取得結果でURLに使う識別子です。post.data.idというデータベース内の識別子とは用途が違います。

errorがある場合は、記事が0件という説明に置き換えず、500という「処理に失敗した」応答を返します。記事が本当に0件なら、通常のページに「まだありません」と表示します。

2. 記事詳細を作る

同じフォルダーに[slug].astroを作ります。角括弧もファイル名に含めてください。

---
import { decodeSlug, getEmDashEntry } from "emdash";
import { PortableText } from "emdash/ui";
import LearningLayout from "../../../layouts/LearningLayout.astro";

const slug = decodeSlug(Astro.params.slug);
if (!slug) {
  return new Response("記事が見つかりません。", { status: 404 });
}

const { entry: post, error } = await getEmDashEntry("posts", slug);
if (error) {
  return new Response("記事を読み込めませんでした。", { status: 500 });
}
if (!post) {
  return new Response("記事が見つかりません。", { status: 404 });
}
---

<LearningLayout title={post.data.title}>
  <article>
    <h1>{post.data.title}</h1>
    <PortableText value={post.data.content ?? []} />
  </article>
  <a href="/practice/posts/">記事一覧に戻る</a>
</LearningLayout>

[slug]は、URLのこの部分を値として受け取る指定です。たとえば/practice/posts/coffee-tools/なら、coffee-toolsを手がかりに記事を探します。記事ごとにAstroファイルを増やす必要はありません。

PortableTextは、CMSが保存した見出しや段落などの本文を画面に出す部品です。本文データはHTML文字列そのものではないので、文字列として貼り付ける代わりに、この部品へ渡します。?? []は、本文が未設定なら空の配列(要素が0件の一覧)を使う指定です。

この例は日本語1言語の練習サイト向けです。多言語サイトでは、言語を含むURLと検索対象の言語も合わせて設計します。

この例で使った部品にどんな値を渡せばよいかは、PortableText 部品で本文を表示するで確認できます。

3. 順番に表示を確認する

開発サーバーを起動したまま、ローカルURLの/practice/posts/を開きます。公開した記事のタイトルをクリックし、本文が表示されれば、一覧と詳細がつながっています。

次に管理画面でタイトルを変更して公開し直し、両方のページで変わるか確認します。下書きのままの記事、存在しないスラッグ、本文が空の記事も確認します。存在しない記事は404、データ取得の失敗は500になる想定です。

タイトルが出ない場合は、管理画面の入力欄の識別名がtitleかを確認します。記事が出ない場合は、同じローカルサイトで公開したか、コレクションがpostsかを確認してください。Cloudflare側の記事は、別のローカルデータベースには自動で現れません。

画像やページ送りを追加するとき

画像を扱うには、画像欄があることを確認して、emdash/uiのImage部品へ、その欄に保存された画像の情報を渡します。管理画面に画像を登録しただけでは、このコードに画像表示は増えません。

記事数が増えたら、件数制限とページ送りを考えます。全件を一度に表示し続ける前に、取得条件と戻り値を確認しましょう。

この例では、仕組みを追いやすいように、検索結果向けの設定(SEO)とキャッシュ設定を省いています。キャッシュは、作ったページなどを保存して再利用する仕組みです。公開用に追加する場合は、EmDashが返すキャッシュ用の情報cacheHintとAstro側の設定を合わせます。設定後は、記事を変更すると公開ページにも反映されるか確認してください。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。