← React / TypeScript

React / TypeScript · 22 / 24

Barrierefreie Formulare und Dialoge

Du prüfst Fokus, Fehlermeldung und Rückkehr zum auslösenden Button in einem echten Browser.

  • Groß
  • Anspruchsvoll
  • 90 min

Voraussetzungen: HTML und CSS: die Grundlage einer Weboberfläche, Erste React-App: JSX, Props und State, Komponenten und Repositories sinnvoll testen

In diesem Tutorial
  1. Das Zustandsmodell verstehen
  2. Das Projekt starten
  3. Den Vertrag mit einem Test prüfen
  4. Fehler und technische Grenzen beobachten
  5. Die Übung umsetzen
  6. Die Musterlösung überprüfen
  7. Übung und Lösung
  8. Projektbezug und Quellen

Lernpaket herunterladen

Einrichtung und Prüfstand

Node.js ab 22.23 mit npm. Zusätzlich Python 3 für den gemeinsamen Prüfstart. Entpacke das Lernpaket in einen neuen Ordner und führe dort python3 run_checks.py aus. Das Skript kopiert die enthaltenen Dateien in einen temporären Lernordner. Dort prüft es zuerst das Beispiel und danach die mitgelieferte Lösung. Die Ausgangsdateien bleiben erhalten. Benötigte Pakete werden beim ersten Lauf aus dem Netz geladen.

Playwright lädt Chromium. Auf einem frischen Linux-System können zusätzlich Browser-Systembibliotheken erforderlich sein. Der Start nennt fehlende Bibliotheken ausdrücklich.

Geprüft am 20.10.2026 unter Linux x86_64. Playwright bedient den Dialog mit der Tastatur. Prüfe Öffnen, Eingabe, Escape und den zurückgegebenen Fokus. Die Übung ergänzt einen weiteren Abbruchweg mit derselben Fokusgarantie.

Ein Dialog unterbricht den normalen Bedienablauf. Sein Name, der Anfangsfokus und der Rückweg müssen verständlich sein. Das native dialog-Element liefert modales Verhalten. Die Anwendung ergänzt die Verbindung zwischen Beschriftung, Eingabe und Fehlermeldung. Ein Browsertest prüft Escape und die Fokusposition.

Paketinhalt und einzelne Dateien

01Das Zustandsmodell verstehen

Ein modaler Dialog braucht einen zugänglichen Namen, einen kontrollierten Fokus und einen Rückweg. Das native dialog-Element übernimmt Modalität. Die Anwendung entscheidet, welches Element beim Öffnen und nach dem Schließen den Fokus erhält.

src/App.tsx · typescriptDatei öffnen
import { useRef, useState } from "react";
export default function App() {
  const dialog = useRef<HTMLDialogElement>(null);
  const trigger = useRef<HTMLButtonElement>(null);
  const [error, setError] = useState("");
  const [saved, setSaved] = useState("");
  return (
    <main>
      <h1>Vehicle records</h1>
      <button
        ref={trigger}
        onClick={() => {
          setError("");
          dialog.current?.showModal();
        }}
      >
        Add vehicle
      </button>
      <p role="status">{saved}</p>
      <dialog
        ref={dialog}
        aria-labelledby="dialog-title"
        onClose={() => trigger.current?.focus()}
      >
        <h2 id="dialog-title">New vehicle</h2>
        <form
          onSubmit={(e) => {
            e.preventDefault();
            const data = new FormData(e.currentTarget);
            const name = String(data.get("name") ?? "").trim();
            if (!name) {
              setError("Name required");
              return;
            }
            setSaved(name);
            dialog.current?.close();
          }}
        >
          <label htmlFor="name">Vehicle name</label>
          <input
            autoFocus
            id="name"
            name="name"
            aria-invalid={!!error}
            aria-describedby={error ? "error" : undefined}
          />
          <p id="error" role="alert">
            {error}
          </p>
          <button>Save</button>
          <button type="button" onClick={() => dialog.current?.close()}>
            Cancel
          </button>
        </form>
      </dialog>
    </main>
  );
}

02Das Projekt starten

Installiere die fest angegebenen Abhängigkeiten und starte npm run dev. Die Daten sind künstliche Lernwerte. Öffne die lokale Adresse und löse die Aktion einmal selbst aus.

package.json · jsonDatei öffnen
{
  "name": "appfabrik-learning",
  "private": true,
  "type": "module",
  "scripts": {
    "dev": "vite --host 127.0.0.1",
    "build": "tsc --noEmit && vite build",
    "test": "playwright test"
  },
  "dependencies": {
    "react": "19.2.3",
    "react-dom": "19.2.3",
    "react-router-dom": "7.18.4",
    "@tanstack/react-query": "5.104.5"
  },
  "devDependencies": {
    "vite": "8.1.5",
    "typescript": "6.0.3",
    "@types/react": "19.2.14",
    "@types/react-dom": "19.2.3",
    "@types/node": "22.19.15",
    "vitest": "4.1.10",
    "@testing-library/react": "16.3.2",
    "@testing-library/user-event": "14.6.1",
    "jsdom": "29.1.1",
    "@playwright/test": "1.64.1"
  }
}

03Den Vertrag mit einem Test prüfen

Playwright bedient den Dialog mit der Tastatur. Prüfe Öffnen, Eingabe, Escape und den zurückgegebenen Fokus. Die Übung ergänzt einen weiteren Abbruchweg mit derselben Fokusgarantie.

tests/workflow.spec.ts · typescriptDatei öffnen
import { test, expect } from "@playwright/test";
test("dialog validates and restores focus", async ({ page }) => {
  await page.goto("/");
  const trigger = page.getByRole("button", { name: "Add vehicle" });
  await trigger.click();
  await expect(page.getByRole("dialog", { name: "New vehicle" })).toBeVisible();
  await expect(page.getByLabel("Vehicle name")).toBeFocused();
  await page.getByRole("button", { name: "Save", exact: true }).click();
  await expect(page.getByRole("alert")).toHaveText("Name required");
  await page.keyboard.press("Escape");
  await expect(trigger).toBeFocused();
  await trigger.click();
  await page.getByLabel("Vehicle name").fill("Family car");
  await page.getByRole("button", { name: "Save", exact: true }).click();
  await expect(page.getByRole("status")).toHaveText("Family car");
  await expect(trigger).toBeFocused();
});

Starten / prüfen

npm install
npm test
npm run build
Erwartetes Ergebnis

Playwright bedient den Dialog mit der Tastatur. Prüfe Öffnen, Eingabe, Escape und den zurückgegebenen Fokus. Die Übung ergänzt einen weiteren Abbruchweg mit derselben Fokusgarantie.

04Fehler und technische Grenzen beobachten

Ändere die erwartete Ausgabe und beobachte einen fehlgeschlagenen Test. Ein TypeScript-Build schützt Typverträge, ein Browsertest schützt Interaktionen. Beide Prüfarten erfüllen unterschiedliche Aufgaben.

05Die Übung umsetzen

Prüfe zusätzlich den Cancel-Button und stelle sicher, dass keine Daten übernommen werden.

06Die Musterlösung überprüfen

Die Lösung tippt einen Entwurf, bricht ab und prüft sowohl den unveränderten bestätigten Zustand als auch den zurückgesetzten Fokus. Ein geschlossener Dialog allein wäre dafür kein ausreichender Nachweis. Kopiere die Lösungsdateien an die entsprechenden Stellen im Lernprojekt und starte Tests und Build erneut.

Erwartetes Ergebnis

Tests und Typprüfung bestehen. Das beobachtete Ergebnis entspricht dem Lernziel.

Deine Übung

Prüfe zusätzlich den Cancel-Button und stelle sicher, dass keine Daten übernommen werden.

Lösung mit Erklärung anzeigen

Die Lösung tippt einen Entwurf, bricht ab und prüft sowohl den unveränderten bestätigten Zustand als auch den zurückgesetzten Fokus. Ein geschlossener Dialog allein wäre dafür kein ausreichender Nachweis.

solution/workflow.spec.ts · typescriptDatei öffnen
import { test, expect } from "@playwright/test";
test("dialog validates and restores focus", async ({ page }) => {
  await page.goto("/");
  const trigger = page.getByRole("button", { name: "Add vehicle" });
  await trigger.click();
  await expect(page.getByRole("dialog", { name: "New vehicle" })).toBeVisible();
  await expect(page.getByLabel("Vehicle name")).toBeFocused();
  await page.getByRole("button", { name: "Save", exact: true }).click();
  await expect(page.getByRole("alert")).toHaveText("Name required");
  await page.keyboard.press("Escape");
  await expect(trigger).toBeFocused();
  await trigger.click();
  await page.getByLabel("Vehicle name").fill("Family car");
  await page.getByRole("button", { name: "Save", exact: true }).click();
  await expect(page.getByRole("status")).toHaveText("Family car");
  await expect(trigger).toBeFocused();
});

test("cancel preserves confirmed state", async ({ page }) => {
  await page.goto("/");
  await page.getByRole("button", { name: "Add vehicle" }).click();
  await page.getByLabel("Vehicle name").fill("Draft");
  await page.getByRole("button", { name: "Cancel", exact: true }).click();
  await expect(page.getByRole("status")).toBeEmpty();
  await expect(page.getByRole("button", { name: "Add vehicle" })).toBeFocused();
});

Projektbezug und Quellen

Das eigenständige Lernprojekt vertieft ein Thema aus diesem Technologiebereich. Die Projektverweise zeigen einen festgehaltenen Quellstand als Architekturkontext. Sie sind kein Beleg dafür, dass jede hier neu eingeführte Bibliothek oder Funktion bereits in dieser App verwendet wird.