Image 部品に渡す値と画像がないときの表示
画像欄を img に変える Image 部品について、画像・代替テキスト・寸法・読み込み優先度の指定を引けます。
目次
EmDashの画像欄を画面に出すには、emdash/ui の Image 部品に、欄から読み取った値をそのまま渡します。ファイル名からURLを組み立てる必要はありません。
よく使う指定
| 指定 | 値 | 省略すると |
|---|---|---|
image | post.data.featured_image などの画像欄 | 表示する写真が決まりません。未設定の欄を渡した場合も画像は出ません |
alt | 写真の内容を伝える短い文字列 | 欄の代替テキストを使います。どちらも空なら alt="" になります |
width / height | 幅と高さを表す数値 | 画像の値が持つ幅と高さを使います |
priority | 最初に大きく表示する写真なら true | 通常は読み込みを遅らせる loading="lazy" が付きます |
画像が登録された記事を1件表示する
練習サイトの src/pages/photo-sample.astro に書く例です。写真付き一覧の実習で「週末の記録 01」に写真を入れてから、/photo-sample/ を開きます。
---
import { getEmDashEntry } from 'emdash';
import { Image } from 'emdash/ui';
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>
<Image image={post.data.featured_image} />実際に出力されたもの
練習用の写真は幅320、高さ180で、代替テキストは「散歩の練習用画像」です。ページのHTMLには同じ幅と高さ、alt="散歩の練習用画像" を持つ img が出ました。priority を付けると、この環境では loading="eager" に変わりました。
写真が空の記事を指定すると、見出しだけが出ます。写真の下に説明文や枠を付ける場合は、post.data.featured_image に値があるときだけ、枠と画像を一緒に表示します。