Skip to content

1. Einführung

Das PDF des Dokuments finden Sie HIER.

Den Code des Dokuments finden Sie HIER.

Dieses Dokument ist ein Produkt von Anthropics KI Claude. Es knüpft an den Kurs „Schritt-für-Schritt-Einführung in das Web-Framework NestJS“ an und verschiebt die Perspektive:

  • Im Kurs [NestJS] generiert der Server die HTML-Seiten (View-Engine [Handlebars]); der Browser zeigt sie lediglich an;
  • in diesem Kurs werden die Seiten im Browser von einer Anwendung [Vue.js] generiert; der Server, der nun nur noch ein einfacher JSON-Server ist, liefert ausschließlich Daten.

Die Seiten der Anwendung bleiben jedoch unverändert: Es sind die der Anwendung [RdvMedecins], die bereits mit den anderen Frameworks vorgestellt wurde (Login mit CAPTCHA, Terminkalender des Arztes, Terminfenster, Patientenbereich, Arzt- und Kundenverwaltung, Kontoerstellung, Französisch und Englisch).

Das Dokument folgt demselben Aufbau wie seine Vorgänger: zunächst zahlreiche kurze Beispiele, die sich jeweils auf ein bestimmtes Konzept von [Vue.js] konzentrieren, gefolgt von einer vollständigen Fallstudie – dem [Vue.js]-Client für die Anwendung [RdvMedecins] – mit vollständig kommentierten Dateien.

Zu [Vue.js] gibt es bereits zwei Kurse: „Einführung in das Framework VUE.JS anhand von Beispielen“ (2019), geschrieben für [Vue.js] 2, und „Ein Client-Server-Beispiel Vue.js / NestJS (2026)“, der sowohl den Server als auch den Client behandelt. Dieses Dokument unterscheidet sich von jenen durch seinen Ansatz: Der Server wird als Blackbox behandelt, für uns sind nur die API und das JSON von Interesse, und wir lernen [Vue.js] Schritt für Schritt kennen, bevor wir den vollständigen Client angehen.

1.1. Die Rolle von Vue.js in einer Webanwendung

Die Anwendung besteht aus zwei Teilen, die ausschließlich über HTTP-Anfragen miteinander kommunizieren:

Image

  • 1: Die [Vue.js]-Anwendung, die im Browser läuft, sendet eine HTTP-Anfrage an den Server, zum Beispiel [GET /api/schedule?doctorId=1&day=2026-10-05];
  • 2: Der Server antwortet mit JSON-Daten: dem Terminkalender dieses Arztes für diesen Tag. Er generiert keine Seiten;
  • 3: Anhand dieser Daten aktualisiert [Vue.js] die im Browser angezeigte Seite, ohne sie neu zu laden.

Das folgende Diagramm vergleicht die beiden Architekturen:

Image

Der Browser lädt beim Start nur eine einzige, nahezu leere Seite – HTML. Alles andere wird von [JavaScript]-Code generiert: Man spricht von einer Single-Page-Anwendung (SPA, für [Single Page Application]). Wenn der Benutzer auf einen internen Link klickt, wird keine Seite vom Server angefordert: Der [Vue.js] -Router ändert die angezeigte URL und ersetzt den Inhalt der Seite.

[Vue.js] ist ein [JavaScript]-Framework, das 2014 von Evan You entwickelt wurde. Es beruht auf zwei Ideen:

  • Komponenten: Die Oberfläche wird in wiederverwendbare Teile zerlegt (eine Navigationsleiste, ein Formularfeld, ein Bestätigungsfenster usw.), die jeweils in einer [.vue]-Datei geschrieben sind, die HTML, Code und Stil vereint;
  • Reaktivität: Die Daten einer Komponente werden „beobachtet“. Sobald sich eine davon ändert, aktualisiert [Vue.js] automatisch die Teile der Seite, die sie anzeigen. Wir schreiben nie Code, der die Seite direkt verändert.

Wir verwenden [Vue.js] 3, geschrieben in [TypeScript], in seiner aktuellsten Form: der Composition API und dem Tag [<script setup>].

1.2. Verwendete Werkzeuge

Die Beispiele wurden mit den folgenden Werkzeugen geschrieben und getestet (ihre Installation ist im Anhang beschrieben):

  • [Node.js] 22 (oder mindestens 20.19) und sein Paketmanager [npm];
  • der Editor [Visual Studio Code] mit der Erweiterung [Vue (Official)];
  • ein aktueller Browser ([Chrome], [Firefox], [Edge]), möglichst mit der Erweiterung [Vue.js devtools];
  • das Kommandozeilenwerkzeug [curl], das die rohen HTTP-Antworten anzeigt;
  • das DBMS [MySQL] (oder [MariaDB]), zum Beispiel das von [Laragon] unter [Windows]: Es wird für den JSON-Server benötigt, wie im Kapitel zu seiner Vorstellung beschrieben.

Die Bibliotheken sind die der [package.json]-Dateien: [Vue.js] 3.5, [Vite] 7 (das Entwicklungs- und Build-Werkzeug), [vue-router] 4 (der Router), [Pinia] 3 (gemeinsamer Zustand), [vue-i18n] 11 (Sprachen), [TypeScript] 5.9, [Bootstrap] 5.3.

1.3. Beispiele

Der Code des Dokuments ist in drei Ordnern organisiert:

1
2
3
4
deliverable/
├── examples-vuejs/          the 20 small Vue.js examples
├── rdvmedecins-nestjs-json/ the RdvMedecins JSON server (the "black box")
└── rdvmedecins-vuejs/       the Vue.js client of the case study

Der Ordner examples enthält einen Unterordner pro Beispiel:

examples-vuejs/
├── 01-first-application/
├── 02-reactivity/
├── ...
├── 20-server-errors/
├── common/              code shared by examples 19 and 20
├── node_modules/
├── index.html           the table of contents of the examples
├── package.json
├── tsconfig.json
└── vite.config.ts

Alle Beispiele teilen sich dieselben Bibliotheken, die in [examples-vuejs/package.json] deklariert sind. Sie werden einmal installiert, in einer Konsole, die im Ordner [examples-vuejs] geöffnet ist (in [VS Code]: Menü Terminal / Neues Terminal):

npm install

Starten Sie dann den [Vite]-Entwicklungsserver:

npm run dev

Ein einziger Server auf Port 5173 stellt alle zwanzig Beispiele bereit. Die Adresse http://localhost:5173/ zeigt ihre Übersicht an:

Image

Sie können von einem Beispiel zum anderen navigieren, indem Sie den Links folgen (http://localhost:5173/01-first-application/, http://localhost:5173/02-reactivity/...). Der [Vite]-Server muss nicht neu gestartet werden: Jede geänderte und gespeicherte Datei wird sofort neu kompiliert, und die Seite im Browser aktualisiert sich automatisch. Sie können ihn beenden, indem Sie [Ctrl-C] in der Konsole eingeben.

Die Beispiele 17 bis 20 befragen die JSON- und [RdvMedecins]-Server: Sie müssen installiert sein und laufen, wie im ihnen gewidmeten Kapitel erläutert.

1.4. Inhalt des Dokuments

Kapitel
Inhalt
Beispiele
Erste Schritte
Ein Vite-Projekt, Reaktivität, Direktiven, Ereignisse, Formulare, Validierung
01 bis 06
Komponenten
Props, Ereignisse, v-model, Slots, Lebenszyklus, Composables, Bestätigungsdialog
07–12
Routing
der Router, Navigations-Guards
13 und 14
Gemeinsamer Zustand
Pinia-Stores
15
Internationalisierung
Eine Anwendung auf Französisch und Englisch
16
Der Server: eine Blackbox
Installation des JSON-Servers, seine API, curl-Beispiele
-
Interaktion mit dem Server
fetch, Anmeldung und Cookies; die API-Zugriffsschicht; Serverfehler
17–20
Fallstudie
Der Vue.js-Client der Anwendung RdvMedecins
-
Bereitstellung
Der kompilierte Client, ausgeliefert vom JSON-Server
-

Jedes Beispiel wird mit seinem vollständigen, Zeile für Zeile kommentierten Code und einem Screenshot seiner Ausführung vorgestellt. Der Code selbst ist ausführlich kommentiert: Diese Kommentare sind Teil des Kurses.