0Pricing
Vue Academy · Lektion

Storybook für Vue 3 einrichten

npx storybook@latest init, .storybook/config, main.js, Stories-Verzeichnis und Ausführung

Storybook für Vue 3 einrichten ist eine kostenlose Vue Academy-Lektion auf CoddyKit. Dies ist Lektion 1 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Vue Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Vue Academy-Kurs umfasst insgesamt 4 Lektionen.

Was ist Storybook?

Storybook ist eine Entwicklungsumgebung zum isolierten Erstellen von UI-Komponenten. Sie rendern jede Komponente in jedem Zustand außerhalb Ihrer App, dokumentieren sie und testen sie visuell – alles in einer dedizierten Browser-Sandbox.

Warum sollten Sie es mit Vue verwenden?

Die Entwicklung eines Buttons oder Modals innerhalb einer tief verschachtelten Seite ist langsam. Mit Storybook sehen Sie eine Komponente für sich, ändern ihre Props direkt und erkennen visuelle Regressionen, bevor sie die App erreichen.

Installation mit einem Befehl

Führen Sie den init-Befehl in Ihrem bestehenden Vue-3-Projekt aus. Dabei werden Vite erkannt, Abhängigkeiten installiert und die Konfiguration sowie Beispiel-Stories erstellt.

// terminal
// npx storybook@latest init

Was init erstellt

Der Initialisierer fügt einen Konfigurationsordner .storybook/, Beispiel-Dateien im Format *.stories.* und npm-Skripte hinzu. Das Vue-3- und Vite-Setup wird automatisch erkannt.

// .storybook/main.ts
// .storybook/preview.ts
// src/stories/*.stories.ts (examples)

Die main.ts-Konfiguration

.storybook/main.ts ist die zentrale Konfiguration: Sie legt fest, wo sich Stories befinden, welche Addons geladen werden und welches Framework verwendet wird. Für Vue 3 + Vite lautet das Framework @storybook/vue3-vite.

// .storybook/main.ts
import type { StorybookConfig } from "@storybook/vue3-vite"

const config: StorybookConfig = {
  stories: ["../src/**/*.stories.@(js|ts)"],
  addons: ["@storybook/addon-essentials"],
  framework: { name: "@storybook/vue3-vite", options: {} },
}
export default config

Der stories-Glob

Das Array stories teilt Storybook mithilfe von Glob-Mustern mit, wo Story-Dateien zu finden sind. Passen Sie es an Ihre Ordnerstruktur an.

stories: [
  "../src/**/*.stories.@(js|jsx|ts|tsx)",
]

Das vue3-vite-Framework

Das Framework-Paket bindet Storybook in Ihre bestehende Vite-Konfiguration ein, sodass Aliase, Plugins und die CSS-Verarbeitung dem Build Ihrer tatsächlichen App entsprechen.

framework: {
  name: "@storybook/vue3-vite",
  options: {},
}

Die Datei preview.ts

.storybook/preview.ts konfiguriert das globale Setup, das für jede Story gilt: globale Decorators, Parameter und der Import globaler CSS-Dateien.

// .storybook/preview.ts
import type { Preview } from "@storybook/vue3"
import "../src/assets/main.css"

const preview: Preview = {
  parameters: {
    controls: { matchers: { color: /color/i } },
  },
}
export default preview

Globale Decorators und Plugins

Wenn Komponenten einen Router oder Pinia benötigen, registrieren Sie diese einmalig in preview.ts über setup, damit jede Story darauf zugreifen kann – ganz ohne Boilerplate pro Story.

// .storybook/preview.ts
import { setup } from "@storybook/vue3"
import { createPinia } from "pinia"

setup((app) => {
  app.use(createPinia())
})

Den Dev-Server starten

Starten Sie Storybook lokal mit dem Dev-Befehl. Der Standard ist Port 6006.

// terminal
// npm run storybook
// or directly:
// storybook dev -p 6006

Ein statisches Storybook erstellen

Erstellen Sie für die Bereitstellung eine statische Website, die Sie überall hosten können. In CI wird diese häufig für Design-Reviews veröffentlicht.

// terminal
// storybook build
// outputs to storybook-static/

Kurzer Check

Überprüfen Sie Ihr Verständnis der Einrichtung von Storybook für Vue 3.

Zusammenfassung

Sie haben Storybook für Vue 3 eingerichtet:

  • Storybook erstellt und dokumentiert Komponenten in Isolation.
  • npx storybook@latest init erstellt die Konfiguration und Beispiele.
  • .storybook/main.ts legt das stories-Glob-Muster, die Addons und das @storybook/vue3-vite-Framework fest.
  • .storybook/preview.ts übernimmt das globale Setup (CSS, Decorators und Plugins wie Pinia).
  • Starten Sie Storybook mit storybook dev -p 6006; erstellen Sie eine statische Website mit storybook build.

Häufig gestellte Fragen

Ist die Lektion „Storybook für Vue 3 einrichten“ kostenlos?

Ja — der vollständige Text von „Storybook für Vue 3 einrichten“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Vue Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Vue Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Storybook für Vue 3 einrichten“?

npx storybook@latest init, .storybook/config, main.js, Stories-Verzeichnis und Ausführung Du übst Vue Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um Vue Academy zu starten?

Keine Vorkenntnisse erforderlich. Vue Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 1 von 4.

Wie lange dauert die Lektion „Storybook für Vue 3 einrichten“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser Vue Academy-Lektion Code schreiben und ausführen?

Ja. Jede Vue Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

  1. Storybook für Vue 3 einrichten
  2. Komponenten-Stories schreiben
  3. Controls, Actions und Args
  4. Storybook-Addons und Accessibility-Tests
← Zurück zu Vue Academy