Image 部品に渡す値と画像がないときの表示

画像欄を img に変える Image 部品について、画像・代替テキスト・寸法・読み込み優先度の指定を引けます。

目次

EmDashの画像欄を画面に出すには、emdash/ui の Image 部品に、欄から読み取った値をそのまま渡します。ファイル名からURLを組み立てる必要はありません。

よく使う指定

指定値省略すると
imagepost.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 に値があるときだけ、枠と画像を一緒に表示します。

公式の参照元

関連ガイド

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

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