Bedienelemente mit ihren Zuständen dokumentieren
Ein Screenshot zeigt nur einen Moment einer Benutzeroberfläche. Für die Umsetzung eines wiederverwendbaren Bedienelements werden zusätzlich seine Zustände und Übergänge benötigt. Dazu gehören etwa Tastaturfokus, laufende Verarbeitung und die Rückmeldung nach einem Fehler.
Verhalten als Teil der Komponente festhalten
- Beschriftung und Funktion des Elements eindeutig benennen.
- Fokusdarstellung und Bedienung mit Tastatur beschreiben.
- Lade- und Fehlerzustände mit verständlicher Rückmeldung vorsehen.
- Festlegen, wann eine Aktion nicht verfügbar ist und wie das vermittelt wird.
Eine wiederverwendete Komponente bringt nur dann einen Vorteil, wenn diese Eigenschaften überall erhalten bleiben. Zusätzliche Linkhüllen, abweichende Ereignisbehandlung oder lokal überschriebene Stile können das Verhalten verändern. Deshalb wird eine repräsentative Verwendung im tatsächlichen Seitenkontext mitgeprüft.
Die Dokumentation dient Gestaltung, Entwicklung und Qualitätssicherung als gemeinsame Grundlage. Sie macht nachvollziehbar, welche Eigenschaften eine neue Variante erfüllen muss.