参照フィールドの定義と戻り値

関連記事を選ぶ欄の設定と、選んだ記事が references のどこに入るかを対応表で引けます。

目次

編集者が「関連記事」欄で選んだ記事は、post.references から読めます。記事を取得するときに、今回使う欄の識別名を指定してください。

「関連記事」欄の設定と読む場所

練習サイトでは posts の記事から、同じ posts の記事を複数選べます。関連記事の実習の教材に設定済みです。

欄を定義するときの指定練習サイトの値意味
slugrelated_postsテーマで指定する欄の識別名
typereference他の記事を選ぶ欄
validation.targetCollectionposts選択の対象になるコレクション
validation.multipletrue複数選べる

選んだ記事のタイトルを読む

src/pages/related-sample.astro に書く例です。実習で「週末の記録 01」に「週末の記録 02」を関連付けた後に /related-sample/ を開くと、後者のタイトルが出ます。

---
import { getEmDashEntry } from 'emdash';

const { entry: post, error } = await getEmDashEntry('posts', 'note-01', {
  references: { related_posts: { limit: 6 } },
});
if (error) return new Response('記事を取得できませんでした。', { status: 500 });
if (!post) return new Response('記事が見つかりません。', { status: 404 });

const related = post.references?.related_posts?.entries ?? [];
---
{related.length > 0 && <ul>
  {related.map(item => <li><a href={`/posts/${item.id}/`}>{item.data.title}</a></li>)}
</ul>}

limit: 6 は今回取得する上限です。entries に参照先の記事が並び、続きがあれば同じ階層の nextCursor に次の取得で使う目印が入ります。

選んだはずの記事が出ないとき

確かめる場所結果の読み方
取得時の references指定を省くと、その欄の参照先は読み込まれません。post.data.related_posts に記事が入ることもありません
entries.length取得を指定しても、表示できる参照先が0件なら 0 になります
参照先の公開状態練習サイトの公開ページでは、公開記事と下書きを同時に選んでも、読者に表示されたのは公開記事だけです

公式の参照元

関連ガイド

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

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