Files
wlkns-dev-standards/design/feedback_guide.md
2025-12-20 15:53:19 +01:00

1.5 KiB
Raw Blame History

FEEDBACK_GUIDE.md

Zweck

Dieses Dokument definiert konsistentes visuelles Feedback in Form von Alerts und Toasts.

Ziel:

  • klare Zustände
  • keine Überraschungen
  • sofort verständliche Rückmeldungen

Grundregeln

  • Feedback ist immer sichtbar
  • Feedback ist textlich eindeutig
  • Farbe unterstützt – ersetzt aber nicht die Aussage

Alerts

Alerts sind statisch und kontextgebunden.

Typische Nutzung:

  • Formularfehler
  • Systemzustände
  • Konfigurationsprobleme

Beispiele

<div class="alert success">Einstellungen gespeichert</div>
<div class="alert warning">Unvollständige Konfiguration</div>
<div class="alert error">Speichern fehlgeschlagen</div>

Regeln:

  • Alert steht nahe am betroffenen Inhalt
  • kein automatisches Verschwinden

Toasts

Toasts sind temporär und nicht blockierend.

Typische Nutzung:

  • Erfolgsmeldungen
  • kurze Hinweise
  • Hintergrundaktionen

Beispiel

<div class="toast success">Änderungen übernommen</div>

Regeln:

  • niemals kritisch
  • immer zeitlich begrenzt
  • dürfen ignoriert werden

Wann was?

Situation Element
Formular ungültig Alert
Aktion erfolgreich Toast
Kritischer Fehler Alert
Hintergrundinfo Toast

Anti-Patterns

  • Toasts für Fehler
  • Alerts ohne Text
  • Farben ohne Bedeutung
  • mehrere Feedback-Typen gleichzeitig

Status

Version: v1.0 (Baseline)

Dieses Dokument ergänzt COMPONENT_GUIDE.md.