参照フィールドの定義と戻り値
関連記事を選ぶ欄の設定と、選んだ記事が references のどこに入るかを対応表で引けます。
目次
編集者が「関連記事」欄で選んだ記事は、post.references から読めます。記事を取得するときに、今回使う欄の識別名を指定してください。
「関連記事」欄の設定と読む場所
練習サイトでは posts の記事から、同じ posts の記事を複数選べます。関連記事の実習の教材に設定済みです。
| 欄を定義するときの指定 | 練習サイトの値 | 意味 |
|---|---|---|
slug | related_posts | テーマで指定する欄の識別名 |
type | reference | 他の記事を選ぶ欄 |
validation.targetCollection | posts | 選択の対象になるコレクション |
validation.multiple | true | 複数選べる |
選んだ記事のタイトルを読む
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 になります |
| 参照先の公開状態 | 練習サイトの公開ページでは、公開記事と下書きを同時に選んでも、読者に表示されたのは公開記事だけです |