← Flutter / Dart

Flutter / Dart · 23 / 24

Barrierefreie Flutter-Formulare

Du prüfst Beschriftungen, Bedienflächen und eine vergrößerte Textdarstellung.

  • Groß
  • Anspruchsvoll
  • 90 min

Voraussetzungen: Formulare prüfen und zwischen Bildschirmen wechseln, Unit- und Widget-Tests mit echten Erwartungen

In diesem Tutorial
  1. Die Grenze festlegen
  2. Das Lernprojekt einrichten
  3. Den Erfolgsfall nachvollziehen
  4. Fehler bewusst beobachten
  5. Die Erweiterung selbst lösen
  6. Die Lösung vergleichen
  7. Übung und Lösung
  8. Projektbezug und Quellen

Lernpaket herunterladen

Einrichtung und Prüfstand

Flutter ab 3.41.5 mit Dart 3.11. 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.

Geprüft am 20.10.2026 unter Linux x86_64. Widgettests prüfen Semantik und das Layout bei vergrößertem Text. Danach bleibt ein manueller Durchlauf mit TalkBack oder VoiceOver erforderlich. Eine Semantikprüfung simuliert keinen vollständigen Screenreader.

Barrierefreiheit entsteht aus mehreren überprüfbaren Eigenschaften. Ein Eingabefeld braucht eine verständliche Beschriftung, eine Aktion ausreichend Platz und ein Formular eine sichtbare Fehlermeldung. Eine starre Bildschirmhöhe kann bei großer Schrift Inhalte abschneiden. Deshalb verwendet dieses Beispiel einen scrollbaren Aufbau und lässt Texte umbrechen. Automatisierte Prüfungen ergänzen einen echten Screenreader-Durchlauf.

Paketinhalt und einzelne Dateien

01Die Grenze festlegen

Ein Formular braucht erkennbare Labels, verständliche Fehler und eine sinnvolle Lesereihenfolge. Semantik beschreibt die Bedeutung für assistive Technik. Flexible Höhen und Scrollbarkeit verhindern abgeschnittene Eingaben bei großer Schrift.

lib/model.dart · dartDatei öffnen
import 'package:flutter/material.dart';

class VehicleForm extends StatefulWidget {
  const VehicleForm({super.key});
  @override
  State<VehicleForm> createState() => _VehicleFormState();
}

class _VehicleFormState extends State<VehicleForm> {
  final controller = TextEditingController();
  String message = '';
  @override
  void dispose() {
    controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) => Scaffold(
    appBar: AppBar(title: const Text('Vehicle record')),
    body: SingleChildScrollView(
      padding: const EdgeInsets.all(24),
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.stretch,
        children: [
          TextField(
            controller: controller,
            decoration: const InputDecoration(labelText: 'Vehicle name'),
          ),
          const SizedBox(height: 24),
          FilledButton(
            onPressed: () => setState(
              () => message = controller.text.trim().isEmpty
                  ? 'Name required'
                  : 'Saved',
            ),
            child: const Text('Save vehicle'),
          ),
          Semantics(liveRegion: true, child: Text(message)),
        ],
      ),
    ),
  );
}

02Das Lernprojekt einrichten

Die Abhängigkeiten sind direkt fixiert. Entpacke alle Dateien zusammen und starte flutter pub get. Verwende für Tests keine bestehende App-Datenbank. Die Testfälle erzeugen ihre eigenen Daten und räumen sie wieder auf.

pubspec.yaml · yamlDatei öffnen
name: learning_example
publish_to: none
environment:
  sdk: ">=3.11.0 <4.0.0"
dependencies:
  flutter:
    sdk: flutter
  flutter_riverpod: 3.3.1
  drift: 2.33.0
  path_provider: 2.1.5
dev_dependencies:
  flutter_test:
    sdk: flutter
flutter:
  uses-material-design: true

03Den Erfolgsfall nachvollziehen

Widgettests prüfen Semantik und das Layout bei vergrößertem Text. Danach bleibt ein manueller Durchlauf mit TalkBack oder VoiceOver erforderlich. Eine Semantikprüfung simuliert keinen vollständigen Screenreader.

test/model_test.dart · dartDatei öffnen
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:learning_example/model.dart';

void main() {
  testWidgets('large text, labelled targets and validation', (tester) async {
    final semantics = tester.ensureSemantics();
    await tester.pumpWidget(
      MaterialApp(
        builder: (context, child) => MediaQuery(
          data: MediaQuery.of(
            context,
          ).copyWith(textScaler: const TextScaler.linear(2)),
          child: child!,
        ),
        home: const VehicleForm(),
      ),
    );
    await expectLater(tester, meetsGuideline(labeledTapTargetGuideline));
    await expectLater(tester, meetsGuideline(androidTapTargetGuideline));
    await tester.tap(find.text('Save vehicle'));
    await tester.pump();
    expect(find.text('Name required'), findsOneWidget);
    await tester.enterText(find.byType(TextField), 'Family car');
    await tester.tap(find.text('Save vehicle'));
    await tester.pump();
    expect(find.text('Saved'), findsOneWidget);
    expect(tester.takeException(), isNull);
    semantics.dispose();
  });
}

Starten / prüfen

flutter pub get
flutter test
Erwartetes Ergebnis

Widgettests prüfen Semantik und das Layout bei vergrößertem Text. Danach bleibt ein manueller Durchlauf mit TalkBack oder VoiceOver erforderlich. Eine Semantikprüfung simuliert keinen vollständigen Screenreader.

04Fehler bewusst beobachten

Ändere eine erwartete Zahl oder einen erwarteten Zustand im Test. flutter test muss fehlschlagen. Stelle danach die richtige Erwartung wieder her. Unterscheide eine fachliche Abweichung von einem fehlenden Plugin oder einer fehlenden Entwicklungsumgebung.

05Die Erweiterung selbst lösen

Prüfe dieselbe Oberfläche zusätzlich bei dreifacher Textgröße und kleiner Bildschirmbreite.

06Die Lösung vergleichen

Der Lösungstest setzt die logische Breite auf 320 Pixel und scrollt die Aktion vor dem Tippen ins Bild. Damit wird der tatsächlich sichtbare und bedienbare Zustand geprüft. TalkBack und VoiceOver benötigen weiterhin eine eigene Geräteprüfung.

Erwartetes Ergebnis

flutter test besteht für Ausgangsbeispiel und ergänzte Lösung.

Deine Übung

Prüfe dieselbe Oberfläche zusätzlich bei dreifacher Textgröße und kleiner Bildschirmbreite.

Lösung mit Erklärung anzeigen

Der Lösungstest setzt die logische Breite auf 320 Pixel und scrollt die Aktion vor dem Tippen ins Bild. Damit wird der tatsächlich sichtbare und bedienbare Zustand geprüft. TalkBack und VoiceOver benötigen weiterhin eine eigene Geräteprüfung.

solution/model_test.dart · dartDatei öffnen
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:learning_example/model.dart';

void main() {
  testWidgets('large text, labelled targets and validation', (tester) async {
    tester.view.physicalSize = const Size(320, 700);
    tester.view.devicePixelRatio = 1;
    addTearDown(tester.view.resetPhysicalSize);
    addTearDown(tester.view.resetDevicePixelRatio);
    final semantics = tester.ensureSemantics();
    await tester.pumpWidget(
      MaterialApp(
        builder: (context, child) => MediaQuery(
          data: MediaQuery.of(
            context,
          ).copyWith(textScaler: const TextScaler.linear(3)),
          child: child!,
        ),
        home: const VehicleForm(),
      ),
    );
    await expectLater(tester, meetsGuideline(labeledTapTargetGuideline));
    await expectLater(tester, meetsGuideline(androidTapTargetGuideline));
    await tester.ensureVisible(find.text('Save vehicle'));
    await tester.tap(find.text('Save vehicle'));
    await tester.pump();
    expect(find.text('Name required'), findsOneWidget);
    await tester.enterText(find.byType(TextField), 'Family car');
    await tester.ensureVisible(find.text('Save vehicle'));
    await tester.tap(find.text('Save vehicle'));
    await tester.pump();
    expect(find.text('Saved'), findsOneWidget);
    expect(tester.takeException(), isNull);
    semantics.dispose();
  });
}

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.