コレクションとフィールド

コレクションはコンテンツタイプ（投稿、ページ、商品）です。そのフィールド定義が各エントリのデータの形状を設定します。

コレクションの作成

管理パネルのContent Typesでコレクションを作成します。各コレクションには以下のプロパティがあります：

コレクション機能

コレクションを作成する際に、必要な機能を有効にします：

以下のコレクションは4つすべての機能を有効にします：

{
  slug: "posts",
  label: "Blog Posts",
  labelSingular: "Post",
  supports: ["drafts", "revisions", "preview", "scheduling"]
}

フィールドタイプ

EmDashはSQLiteカラムタイプにマッピングされる16のフィールドタイプをサポートしています。

テキストフィールド

{ slug: "title", type: "string", label: "Title" }

{ slug: "excerpt", type: "text", label: "Excerpt" }

{ slug: "handle", type: "slug", label: "URL Handle" }

リッチコンテンツ

{ slug: "content", type: "portableText", label: "Content" }

{ slug: "metadata", type: "json", label: "Custom Metadata" }

数値

{ slug: "price", type: "number", label: "Price" }

{ slug: "quantity", type: "integer", label: "Stock Quantity" }

ブーリアンと日付

{ slug: "featured", type: "boolean", label: "Featured Post" }

{ slug: "eventDate", type: "datetime", label: "Event Date" }

選択

{
  slug: "status",
  type: "select",
  label: "Product Status",
  validation: {
    options: ["active", "discontinued", "coming_soon"]
  }
}

{
  slug: "features",
  type: "multiSelect",
  label: "Product Features",
  validation: {
    options: ["wireless", "waterproof", "eco-friendly"]
  }
}

メディアと参照

{ slug: "featuredImage", type: "image", label: "Featured Image" }

{ slug: "attachment", type: "file", label: "PDF Attachment" }

{
  slug: "author",
  type: "reference",
  label: "Author",
  options: {
    collection: "authors"
  }
}

フィールドプロパティ

すべてのフィールドがこれらのプロパティをサポートしています：

コレクションクエリがorderByまたはフィールドフィルターでカスタムフィールドを使用する必要がある場合、indexed: trueを設定してください。インデックスはstring、url、number、integer、boolean、datetime、select、reference、slugフィールドでサポートされています。EmDashはインデックス付きJSON、リッチコンテンツ、その他の非スカラーフィールドタイプを拒否します。

バリデーションルール

validationオブジェクトはフィールドタイプによって異なります。その完全な形状は：

interface FieldValidation {
	required?: boolean; // すべてのタイプ
	min?: number; // number, integer
	max?: number; // number, integer
	minLength?: number; // string, text
	maxLength?: number; // string, text
	pattern?: string; // string（正規表現）
	options?: string[]; // select, multiSelect
}

以下のフィールドは、一意でパターンマッチされたメールアドレスを要求します：

{
  slug: "email",
  type: "string",
  label: "Email Address",
  required: true,
  unique: true,
  validation: {
    pattern: "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$"
  }
}

ウィジェットオプション

optionsオブジェクトはフィールド固有のUI動作を設定します。その完全な形状は：

interface FieldWidgetOptions {
	rows?: number; // text（テキストエリアの行数）
	showPreview?: boolean; // image, file
	collection?: string; // reference（ターゲットコレクション）
	allowMultiple?: boolean; // reference（複数参照）
	[key: string]: unknown; // カスタムウィジェットオプション
}

以下の参照フィールドは複数の商品にリンクします：

{
  slug: "relatedProducts",
  type: "reference",
  label: "Related Products",
  options: {
    collection: "products",
    allowMultiple: true
  }
}

コレクションのクエリ

提供されたクエリ関数を使用してコンテンツを取得します。これらはAstroのライブコレクションパターンに従い、構造化された結果を返します。以下の例は一般的なクエリオプションを示しています：

import { getEmDashCollection, getEmDashEntry } from "emdash";

// すべてのエントリを取得 - { entries, error } を返す
const { entries: posts } = await getEmDashCollection("posts");

// ステータスでフィルター
const { entries: drafts } = await getEmDashCollection("posts", {
	status: "draft",
});

// 結果を制限
const { entries: recent } = await getEmDashCollection("posts", {
	limit: 5,
});

// タクソノミーでフィルター
const { entries: newsPosts } = await getEmDashCollection("posts", {
	where: { category: "news" },
});

// slugで単一エントリを取得 - { entry, error, isPreview } を返す
const { entry: post } = await getEmDashEntry("posts", "my-post-slug");

// エラーハンドリング
const { entries, error } = await getEmDashCollection("posts");
if (error) {
	console.error("Failed to load posts:", error);
}

型生成

npx emdash typesを実行してスキーマからTypeScript型を生成します。生成されたファイルにはコレクションごとに1つのインターフェースが含まれます：

export interface Post {
	title: string;
	content: PortableTextBlock[];
	excerpt?: string;
	featuredImage?: string;
	author: string; // 参照ID
}

export interface Product {
	title: string;
	price: number;
	description: PortableTextBlock[];
}

データベースマッピング

フィールドタイプは以下のようにSQLiteカラムタイプにマッピングされます：

次のステップ