Collections et champs

Les collections sont la base du modèle de contenu d’EmDash. Chaque collection représente un type de contenu (articles, pages, produits) et contient des définitions de champs qui déterminent la forme de vos données.

Créer des collections

Créez des collections depuis le panneau d’administration, sous Types de contenu. Chaque collection comporte :

Fonctionnalités de collection

Lors de la création d’une collection, activez les fonctionnalités nécessaires :

// Exemple de collection avec toutes les fonctionnalités
{
  slug: "posts",
  label: "Blog Posts",
  labelSingular: "Post",
  supports: ["drafts", "revisions", "preview", "scheduling"]
}

Types de champs

EmDash prend en charge 15 types de champs, mappés sur des types de colonnes SQLite :

Champs texte

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

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

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

Contenu riche

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

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

Nombres

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

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

Booléens et dates

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

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

Sélection

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

Médias et références

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

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

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

Propriétés des champs

Chaque champ prend en charge ces propriétés :

Règles de validation

L’objet validation varie selon le type de champ :

interface FieldValidation {
	required?: boolean; // tous les 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
}

Exemple avec validation :

{
  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 de widget

L’objet options configure le comportement d’UI propre au champ :

interface FieldWidgetOptions {
	rows?: number; // text (lignes du textarea)
	showPreview?: boolean; // image, file
	collection?: string; // reference (collection cible)
	allowMultiple?: boolean; // reference (plusieurs références)
	[key: string]: unknown; // options de widget personnalisées
}

Exemple de champ de référence :

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

Interroger les collections

Utilisez les fonctions de requête fournies pour récupérer le contenu. Elles suivent le modèle des collections en direct d’Astro et renvoient des résultats structurés :

import { getEmDashCollection, getEmDashEntry } from "emdash";

// Toutes les entrées — renvoie { entries, error }
const { entries: posts } = await getEmDashCollection("posts");

// Filtrer par statut
const { entries: drafts } = await getEmDashCollection("posts", {
	status: "draft",
});

// Limiter les résultats
const { entries: recent } = await getEmDashCollection("posts", {
	limit: 5,
});

// Filtrer par taxonomie
const { entries: newsPosts } = await getEmDashCollection("posts", {
	where: { category: "news" },
});

// Une entrée par slug — renvoie { entry, error, isPreview }
const { entry: post } = await getEmDashEntry("posts", "my-post-slug");

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

Génération de types

Exécutez npx emdash types pour générer des types TypeScript à partir de votre schéma :

// .emdash/types.ts (généré)
export interface Post {
	title: string;
	content: PortableTextBlock[];
	excerpt?: string;
	featuredImage?: string;
	author: string; // ID de référence
}

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

Correspondance en base

Les types de champs correspondent aux types de colonnes SQLite :

Étapes suivantes