ページレイアウト

このページ

エディター内のドロップダウンから、ページごとにレイアウト(例:デフォルト、全幅、ランディングページ)を選択できるようにします。これは、ページルート内のレイアウトコンポーネントにマッピングされた select フィールドを使用します。

仕組み

  1. ページコレクションに template セレクトフィールドを追加
  2. 各オプションのレイアウトコンポーネントを作成
  3. ページルートでフィールド値をレイアウトにマッピング

これは、EmDashのセレクトフィールドとAstroのコンポーネントモデルを使用します。

フィールドの追加

管理UIで、ページコレクションにスラッグ template とレイアウトオプション(例:“Default”、“Full Width”)を持つセレクトフィールドを追加します。またはシードデータに含めます:

{
  "slug": "template",
  "label": "Template",
  "type": "select",
  "validation": {
    "options": ["Default", "Full Width"]
  },
  "defaultValue": "Default"
}

レイアウトコンポーネントの作成

各レイアウトは、ベースレイアウト内のコンテンツを異なるスタイルでラップします:

---
import type { ContentEntry } from "emdash";
import { PortableText } from "emdash/ui";
import Base from "./Base.astro";

interface Props {
  page: ContentEntry<any>;
}

const { page } = Astro.props;
---

<Base title={page.data.title}>
  <article class="page-default">
    <h1>{page.data.title}</h1>
    <PortableText value={page.data.content} />
  </article>
</Base>

<style>
  .page-default {
    max-width: var(--content-width);
    margin: 0 auto;
    padding: 2rem 1rem;
  }
</style>
---
import type { ContentEntry } from "emdash";
import { PortableText } from "emdash/ui";
import Base from "./Base.astro";

interface Props {
  page: ContentEntry<any>;
}

const { page } = Astro.props;
---

<Base title={page.data.title}>
  <article class="page-wide">
    <h1>{page.data.title}</h1>
    <PortableText value={page.data.content} />
  </article>
</Base>

<style>
  .page-wide {
    max-width: var(--wide-width);
    margin: 0 auto;
    padding: 2rem 1rem;
  }
</style>

ルートの接続

ページルートで、各レイアウトをインポートし、テンプレート値をマッピングします:

---
import { getEmDashEntry } from "emdash";
import PageDefault from "../../layouts/PageDefault.astro";
import PageFullWidth from "../../layouts/PageFullWidth.astro";

const { slug } = Astro.params;

if (!slug) {
  return Astro.redirect("/404");
}

const { entry: page } = await getEmDashEntry("pages", slug);

if (!page) {
  return Astro.redirect("/404");
}

const layouts = {
  "Default": PageDefault,
  "Full Width": PageFullWidth,
};

const Layout = layouts[page.data.template as keyof typeof layouts] ?? PageDefault;
---

<Layout page={page} />

ルートは小さいままです。各レイアウトコンポーネントは、独自のマークアップとスタイルを所有します。レイアウトの追加は、コンポーネントを作成し、セレクトフィールドにオプションを追加し、マップに行を追加するだけです。

さらにレイアウトを追加

一般的なレイアウトの選択肢:

  • Default — 狭いコンテンツカラム、読みやすい
  • Full Width — より広いコンテンツエリア、サイドバーなし
  • Landing Page — ヘッダー/フッターなし、ヒーローセクション
  • Sidebar — サイドバーウィジェットエリア付きコンテンツ

それぞれは src/layouts/ ディレクトリ内の別のAstroコンポーネントであり、ルートのレイアウトマップ内の別のエントリです。