セクションは、編集者が /section コマンドで任意のコンテンツに挿入できる再利用ブロックです。CTA、お客様の声、機能一覧などに使います。
取得
getSection(slug) と getSections({ source, search }) のシグネチャ・戻り値は英語版と同じです。
データ構造・ソース種別
Section インターフェースと theme / user / import の説明は英語版と同じ表を参照してください。
エディタでの利用
-
/section(または/patternなど)を入力 -
検索または一覧から選択
-
カーソル位置に挿入
挿入後はドキュメント内のコピーが独立するため、元セクションの変更は既存挿入に影響しません。
作成・シード・WordPress インポート
管理 UI、テーマシード JSON、WordPress 再利用ブロックの流れは英語版と同じです。
テンプレートでの描画
---
import { getSection } from "emdash";
import { PortableText } from "emdash/ui";
const newsletter = await getSection("newsletter-cta");
---
{newsletter && (
<aside class="cta-box">
<PortableText value={newsletter.content} />
</aside>
)}
API・REST
getSection / getSections と /_emdash/api/sections の各メソッドは英語版ドキュメントの記載と同一です。