記事のフィールドと entry.data の対応表
「タイトル」「写真」「本文」が、Astroからどんな名前と形で読めるかを練習サイトの1件で確認します。
目次
管理画面の「タイトル」を見出しに出すには、記事を取得して post.data.title を読みます。post はこの記事に付けた変数名、data が記事の中身、title が編集欄の識別名です。
入力欄と値の対応
次は練習サイト「週末ノート」の posts コレクション(記事の入れ物)です。別のサイトで欄の識別名を summary にした場合は、テーマ側でも post.data.summary と書きます。
| 管理画面の欄 | 読む場所 | 「週末の記録 01」で読めた値 | 表示の仕方 |
|---|---|---|---|
| タイトル | post.data.title | "週末の記録 01" | 見出しに入れる |
| 要約 | post.data.excerpt | "1回目の散歩です。" | 入力されているときだけ段落を出す |
| 写真 | post.data.featured_image | 写真のID、代替テキスト、幅・高さなどを持つオブジェクト | 値をまとめて Image部品に渡す |
| 本文 | post.data.content | 段落などを並べた配列 | PortableText部品に渡す |
必須のタイトルと任意の要約を表示する
「週末ノート」を準備する手順まで進めると、タイトルと要約の入った記事 note-01 が使えます。
練習サイトの src/pages/field-sample.astro に書く例です。ローカルでサイトを起動して /field-sample/ を開くと、見出しの下に要約が出ます。
---
import { getEmDashEntry } from 'emdash';
const { entry: post, error } = await getEmDashEntry('posts', 'note-01');
if (error) return new Response('記事を取得できませんでした。', { status: 500 });
if (!post) return new Response('記事が見つかりません。', { status: 404 });
---
<h1>{post.data.title}</h1>
{post.data.excerpt && <p>{post.data.excerpt}</p>}&& の右側は、要約に文字が入っているときだけ表示されます。入力が任意の欄は、空のときに段落や写真の枠を出すかもテーマで決めます。
自分のサイトで識別名を確かめる
練習サイトでは、作業フォルダー直下の emdash-env.d.ts に Post という記事の型があります。ここにある excerpt?: string は「要約は文字列で、省略できる」という意味です。項目を追加・変更したときの確認方法は入力項目から型を作る実習で試せます。
「関連記事」のように別の記事を選ぶ欄は、参照フィールドの戻り値を参照してください。