記事のフィールドと 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 は「要約は文字列で、省略できる」という意味です。項目を追加・変更したときの確認方法は入力項目から型を作る実習で試せます。

「関連記事」のように別の記事を選ぶ欄は、参照フィールドの戻り値を参照してください。

公式の参照元

関連ガイド

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

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