Astro
Übersicht
Astro ist ein Web-Framework für die Erstellung inhaltsorientierter Websites, das standardmäßig kein JavaScript ausliefert. Seine Insel-Architektur hydriert nur interaktive Komponenten und erzielt dabei hervorragende Lighthouse-Ergebnisse, wobei React, Vue, Svelte oder jedes andere UI-Framework unterstützt wird, wo Interaktivität benötigt wird.
Anleitung
- Beim Erstellen von Seiten das dateibasierte Routing in
src/pages/mit.astro,.mdoder.mdx-Dateien verwenden und gemeinsam genutzte Strukturen insrc/layouts/organisieren. - Beim Hinzufügen von Interaktivität Client-Direktiven auf Framework-Komponenten verwenden:
client:visibleoderclient:idlegegenüberclient:loadbevorzugen, da die meisten Komponenten keine sofortige Hydrierung benötigen. - Bei der Inhaltsverwaltung Content Collections in
src/content/mit strengen Zod-Schemas mittelsdefineCollection()definieren und mitgetCollection()sowiegetEntry()abfragen. - Bei der Wahl des Rendering-Modus standardmäßig statisch (SSG) für Marketing- und Inhaltsseiten verwenden,
output: "server"für dynamische Seiten oder hybrides Rendering mitexport const prerender = falsepro Seite. - Bei der Bildoptimierung die
<Image>-Komponente ausastro:assetsfür automatische Formatkonvertierung (WebP/AVIF), Größenanpassung und Lazy Loading anstelle roher<img>-Tags nutzen. - Beim Hinzufügen von Seitenübergängen View Transitions mit
<ViewTransitions />aktivieren, um SPA-ähnliche Navigation ohne clientseitigen Router zu ermöglichen. - Bei der Integration von UI-Frameworks die entsprechende Integration (
@astrojs/react,@astrojs/vue,@astrojs/svelte) installieren und Astro-Komponenten für statische Inhalte verwenden; Framework-Komponenten nur dann einsetzen, wenn Interaktivität erforderlich ist.
Beispiele
Beispiel 1: Einen Blog mit Content Collections erstellen
Benutzeranfrage: „Erstelle einen Astro-Blog mit typsicheren Markdown-Inhalten“
Aktionen:
- Eine Blog-Content-Collection mit Zod-Schema für Frontmatter (Titel, Datum, Tags, Autor) definieren
- Dynamische Route
src/pages/blog/[slug].astromitgetStaticPaths()erstellen - Blog-Indexseite mit Abfrage von
getCollection("blog")und Sortierung bauen - Layout mit SEO-Meta-Tags, Navigation und View Transitions hinzufügen
Ergebnis: Ein statisch generierter Blog mit validierten Inhalten, sauberen URLs und flüssigen Seitenübergängen.
Beispiel 2: Interaktive Komponenten zu einer statischen Website hinzufügen
Benutzeranfrage: „Füge eine React-Suchkomponente zu meiner Astro-Dokumentationsseite hinzu“
Aktionen:
- Integration
@astrojs/reactinstallieren - React-Suchkomponente mit Zustand und Ereignisbehandlung erstellen
- Die Komponente auf der Seite mit der Direktive
client:idleplatzieren - Statische Daten als Props aus dem Frontmatter der Astro-Seite übergeben
Ergebnis: Eine Dokumentationsseite, die vollständig statisch ist, bis auf die interaktive Suchinsel.
Richtlinien
- Astro-Komponenten (
.astro) für statische Inhalte verwenden; React/Vue/Svelte nur dann einsetzen, wenn Interaktivität benötigt wird. - Standardmäßig
client:visibleoderclient:idlegegenüberclient:loadfür Hydrierungsdirektiven bevorzugen. - Content Collections mit strengen Zod-Schemas definieren, um Inhaltsfehler zur Build-Zeit zu erkennen.
astro:assets<Image>anstelle roher<img>-Tags für automatische Optimierung nutzen.- Layouts schlank halten: gemeinsame
<head>, Navigation und Footer; seiten-spezifische Inhalte in den Seiten ablegen. - Hybrides Rendering verwenden: statisch für Marketingseiten, SSR nur für personalisierte oder dynamische Seiten.
- View Transitions aktivieren, um SPA-ähnliche Navigation ohne Router-Auslieferung zu ermöglichen.