Collezioni e campi

Una collezione è un tipo di contenuto (articoli, pagine, prodotti). Le definizioni dei campi stabiliscono la struttura dei dati di ogni voce.

Creare collezioni

Crea collezioni tramite il pannello di amministrazione sotto Content Types. Ogni collezione ha le seguenti proprietà:

Funzionalità delle collezioni

Quando crei una collezione, abilita le funzionalità di cui hai bisogno:

La seguente collezione abilita tutte e quattro le funzionalità:

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

Tipi di campo

EmDash supporta 16 tipi di campo che corrispondono ai tipi di colonna SQLite.

Campi di testo

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

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

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

Contenuto ricco

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

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

Numeri

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

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

Booleani e date

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

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

Selezione

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

Media e riferimenti

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

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

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

Proprietà dei campi

Ogni campo supporta queste proprietà:

Imposta indexed: true quando una query di collezione deve utilizzare un campo personalizzato in orderBy o un filtro di campo. Gli indici sono supportati per i campi string, url, number, integer, boolean, datetime, select, reference e slug. EmDash rifiuta i campi JSON indicizzati, il contenuto ricco e altri tipi di campo non scalari.

Regole di validazione

L’oggetto validation varia in base al tipo di campo. La sua forma completa è:

interface FieldValidation {
	required?: boolean; // Tutti i tipi
	min?: number; // number, integer
	max?: number; // number, integer
	minLength?: number; // string, text
	maxLength?: number; // string, text
	pattern?: string; // string (regex)
	options?: string[]; // select, multiSelect
}

Il seguente campo richiede un indirizzo email unico e validato tramite pattern:

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

Opzioni widget

L’oggetto options configura il comportamento UI specifico del campo. La sua forma completa è:

interface FieldWidgetOptions {
	rows?: number; // text (righe dell'area di testo)
	showPreview?: boolean; // image, file
	collection?: string; // reference (collezione di destinazione)
	allowMultiple?: boolean; // reference (ref multipli)
	[key: string]: unknown; // Opzioni widget personalizzate
}

Il seguente campo di riferimento collega a più prodotti:

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

Interrogare le collezioni

Usa le funzioni di query fornite per recuperare il contenuto. Queste seguono il pattern delle collezioni live di Astro, restituendo risultati strutturati. L’esempio seguente mostra le opzioni di query comuni:

import { getEmDashCollection, getEmDashEntry } from "emdash";

// Ottenere tutte le voci - restituisce { entries, error }
const { entries: posts } = await getEmDashCollection("posts");

// Filtrare per stato
const { entries: drafts } = await getEmDashCollection("posts", {
	status: "draft",
});

// Limitare i risultati
const { entries: recent } = await getEmDashCollection("posts", {
	limit: 5,
});

// Filtrare per tassonomia
const { entries: newsPosts } = await getEmDashCollection("posts", {
	where: { category: "news" },
});

// Ottenere una voce per slug - restituisce { entry, error, isPreview }
const { entry: post } = await getEmDashEntry("posts", "my-post-slug");

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

Generazione dei tipi

Esegui npx emdash types per generare tipi TypeScript dal tuo schema. Il file generato contiene un’interfaccia per collezione:

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

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

Mappatura del database

I tipi di campo corrispondono ai tipi di colonna SQLite come segue:

Prossimi passi