Collections & Felder

Collections sind die Basis von EmDashs Inhaltsmodell. Jede Collection steht für einen Inhaltstyp (Beiträge, Seiten, Produkte) und enthält Felddefinitionen, die die Form deiner Daten festlegen.

Collections anlegen

Collections legst du im Admin unter Inhaltstypen an. Jede Collection hat:

Collection-Features

Beim Anlegen einer Collection aktivierst du die benötigten Features:

// Beispiel-Collection mit allen Features
{
  slug: "posts",
  label: "Blog Posts",
  labelSingular: "Post",
  supports: ["drafts", "revisions", "preview", "scheduling"]
}

Feldtypen

EmDash unterstützt 15 Feldtypen, die SQLite-Spaltentypen zugeordnet werden:

Textfelder

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

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

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

Rich Content

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

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

Zahlen

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

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

Booleans & Daten

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

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

Auswahl

{
  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"]
  }
}

Medien & Referenzen

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

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

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

Feldeigenschaften

Jedes Feld unterstützt diese Eigenschaften:

Validierungsregeln

Das Objekt validation hängt vom Feldtyp ab:

interface FieldValidation {
	required?: boolean; // alle Typen
	min?: number; // number, integer
	max?: number; // number, integer
	minLength?: number; // string, text
	maxLength?: number; // string, text
	pattern?: string; // string (Regex)
	options?: string[]; // select, multiSelect
}

Beispiel mit Validierung:

{
  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,}$"
  }
}

Widget-Optionen

Das Objekt options steuert feldspezifisches UI-Verhalten:

interface FieldWidgetOptions {
	rows?: number; // text (Textarea-Zeilen)
	showPreview?: boolean; // image, file
	collection?: string; // reference (Ziel-Collection)
	allowMultiple?: boolean; // reference (mehrere Verweise)
	[key: string]: unknown; // Custom-Widget-Optionen
}

Beispiel Referenzfeld:

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

Collections abfragen

Nutze die mitgelieferten Abfragefunktionen für Inhalte. Sie folgen dem Live-Collections-Muster von Astro und liefern strukturierte Ergebnisse:

import { getEmDashCollection, getEmDashEntry } from "emdash";

// Alle Einträge – liefert { entries, error }
const { entries: posts } = await getEmDashCollection("posts");

// Nach Status filtern
const { entries: drafts } = await getEmDashCollection("posts", {
	status: "draft",
});

// Ergebnis begrenzen
const { entries: recent } = await getEmDashCollection("posts", {
	limit: 5,
});

// Nach Taxonomie filtern
const { entries: newsPosts } = await getEmDashCollection("posts", {
	where: { category: "news" },
});

// Einzelner Eintrag per Slug – liefert { entry, error, isPreview }
const { entry: post } = await getEmDashEntry("posts", "my-post-slug");

// Fehler behandeln
const { entries, error } = await getEmDashCollection("posts");
if (error) {
	console.error("Failed to load posts:", error);
}

Typgenerierung

Führe npx emdash types aus, um TypeScript-Typen aus deinem Schema zu erzeugen:

// .emdash/types.ts (generiert)
export interface Post {
	title: string;
	content: PortableTextBlock[];
	excerpt?: string;
	featuredImage?: string;
	author: string; // Referenz-ID
}

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

Abbildung auf die Datenbank

Feldtypen werden SQLite-Spaltentypen zugeordnet:

Nächste Schritte