Sammlungen & Felder

Sammlungen sind die Grundlage des Inhaltsmodells von EmDash. Jede Sammlung repräsentiert einen Inhaltstyp (Beiträge, Seiten, Produkte) und enthält Felddefinitionen, die die Struktur Ihrer Daten bestimmen.

Sammlungen erstellen

Erstellen Sie Sammlungen über das Admin-Oberfläche unter Inhaltstypen. Jede Sammlung hat:

Eigenschaft	Beschreibung
slug	URL-sicherer Bezeichner (z.B. posts, products)
label	Anzeigename (z.B. “Blogbeiträge”)
labelSingular	Singularform (z.B. “Beitrag”)
description	Optionale Beschreibung für Redakteure
icon	Lucide-Icon-Name für die Admin-Seitenleiste
supports	Funktionen wie Entwürfe, Revisionen, Vorschau, Zeitplanung, Suche, SEO

Hinweis

Einige Sammlungs-Slugs sind reserviert: content, media, users, revisions, taxonomies, options, audit_logs.

Sammlungsfunktionen

Beim Erstellen einer Sammlung aktivieren Sie die benötigten Funktionen:

Funktion	Beschreibung
drafts	Entwurf/Veröffentlicht-Workflow aktivieren
revisions	Inhaltsverlauf mit Versions-Snapshots verfolgen
preview	Signierte Vorschau-URLs für Entwurfsinhalte generieren
scheduling	Inhalte für Veröffentlichung zu einem zukünftigen Datum planen

// Example collection with all features enabled
{
  slug: "posts",
  label: "Blog Posts",
  labelSingular: "Post",
  supports: ["drafts", "revisions", "preview", "scheduling"]
}

Feldtypen

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

Textfelder

string

Kurze Texteingabe. Wird der TEXT-Spalte zugeordnet.

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

text

Mehrzeiliges Textfeld. Wird der TEXT-Spalte zugeordnet.

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

slug

URL-sicheres Slug-Feld. Wird der TEXT-Spalte zugeordnet.

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

Rich Content

portableText

Rich-Text-Editor (TipTap/ProseMirror). Wird als JSON gespeichert.

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

Portable Text ist ein blockbasiertes Format, das Struktur erhält, ohne HTML einzubetten.

json

Beliebige JSON-Daten. Wird als JSON gespeichert.

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

Zahlen

number

Dezimalzahlen. Wird der REAL-Spalte zugeordnet.

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

integer

Ganze Zahlen. Wird der INTEGER-Spalte zugeordnet.

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

Booleans & Datumsangaben

boolean

Wahr/Falsch-Umschalter. Wird INTEGER (0/1) zugeordnet.

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

datetime

Datums- und Zeitauswahl. Wird als ISO-8601-Zeichenkette gespeichert.

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

Auswahl

select

Einzelne Option aus einer Liste. Wird der TEXT-Spalte zugeordnet.

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

multiSelect

Mehrere Optionen aus einer Liste. Wird als JSON-Array gespeichert.

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

Medien & Referenzen

image

Bildauswahl aus der Mediathek. Speichert Medien-ID als TEXT.

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

file

Dateiauswahl aus der Mediathek. Speichert Medien-ID als TEXT.

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

reference

Referenz auf einen Eintrag einer anderen Sammlung. Speichert Eintrags-ID als TEXT.

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

Feldeigenschaften

Jedes Feld unterstützt diese Eigenschaften:

Eigenschaft	Typ	Beschreibung
slug	string	Spaltenname in der Datenbank
label	string	Anzeigelabel in der Admin-UI
type	FieldType	Einer der 15 Feldtypen
required	boolean	Ob das Feld einen Wert haben muss
unique	boolean	Ob Werte über Einträge hinweg eindeutig sein müssen
defaultValue	unknown	Standardwert für neue Einträge
validation	object	Typspezifische Validierungsregeln
widget	string	Benutzerdefinierter Widget-Bezeichner
options	object	Widget-spezifische Konfiguration
sortOrder	number	Anzeigereihenfolge im Editor

Achtung

Einige Feld-Slugs sind reserviert und können nicht verwendet werden: id, slug, status, author_id, primary_byline_id, created_at, updated_at, published_at, scheduled_at, deleted_at, version, live_revision_id, draft_revision_id.

Validierungsregeln

Das validation-Objekt variiert je nach Feldtyp:

interface FieldValidation {
  required?: boolean; // All types
  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 options-Objekt konfiguriert das feld-spezifische UI-Verhalten:

interface FieldWidgetOptions {
  rows?: number; // text (textarea rows)
  showPreview?: boolean; // image, file
  collection?: string; // reference (target collection)
  allowMultiple?: boolean; // reference (multiple refs)
  [key: string]: unknown; // Custom widget options
}

Beispiel-Referenzfeld:

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

Sammlungen abfragen

Verwenden Sie die bereitgestellten Abfragefunktionen, um Inhalte abzurufen. Diese folgen Astros Live-Sammlungs-Muster und geben strukturierte Ergebnisse zurück:

import { getEmDashCollection, getEmDashEntry } from "emdash";

// Alle Einträge abrufen - gibt { entries, error } zurück
const { entries: posts } = await getEmDashCollection("posts");

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

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

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

// Einen einzelnen Eintrag anhand des Slugs abrufen - gibt { entry, error, isPreview } zurück
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ühren Sie npx emdash types aus, um TypeScript-Typen aus Ihrem Schema zu generieren:

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

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

Tipp

Führen Sie emdash types erneut aus, nachdem Sie Sammlungen im Admin-Oberfläche geändert haben, um die Typen synchron zu halten.

Datenbankzuordnung

Feldtypen werden auf SQLite-Spaltentypen abgebildet:

Feldtyp	SQLite-Typ	Anmerkungen
string	TEXT
text	TEXT
slug	TEXT
number	REAL	64-Bit-Gleitkommazahl
integer	INTEGER	64-Bit-Ganzzahl mit Vorzeichen
boolean	INTEGER	0 oder 1
datetime	TEXT	ISO-8601-Format
select	TEXT
multiSelect	JSON	Array von Strings
portableText	JSON	Block-Array
image	TEXT	Medien-ID
file	TEXT	Medien-ID
reference	TEXT	Eintrags-ID
json	JSON	Beliebiges JSON

Nächste Schritte

Inhaltsmodell

Verstehen Sie den datenbankorientierten Ansatz.

Taxonomien

Organisieren Sie Inhalte mit Kategorien und Tags.

Medienbibliothek

Verwalten Sie Bilder und Dateien.