major
#29540
Feedback zur Benutzerfreundlichkeit des Benutzermenüs und des Dialogfelds „Persönliche Einstellungen“
Folgebeitrag zu #29525 (das Benutzermenü der App-Leiste der Ebene „com.top_logic.layout.view“ ). Feedback zur Benutzerfreundlichkeit der ersten Version und welche Maßnahmen zu den einzelnen Punkten ergriffen wurden.
Die Anmeldung ist hinter dem Menü versteckt
Die Anmeldung ist hinter dem Menü versteckt und schwer zu finden. Wenn kein Benutzer angemeldet ist, sollte „Anmelden“ direkt sichtbar sein.
In einer anonymen Sitzung wird ein Avatar des anonymen Kontos angezeigt, und die Anmeldung ist erst nach dem Öffnen verfügbar. Der Kontobereich (user-menu.view.xml) wird zu einem <switch> für den aktuellen Nutzer: Eine anonyme Sitzung erhält eine einfache Anmelde-Schaltfläche und sonst nichts – keinen Avatar, kein Menü, also auch keinen Themenwechsel vor der Anmeldung – und eine angemeldete Sitzung erhält das Menü, in dem der Eintrag „Anmelden“ fehlt. „Abmelden“ bleibt im Menü: Die abgemeldete Person sucht nach der Abmeldefunktion, und im Menü befindet sich der Rest ihres Kontos.
Der Schalter muss das anonyme Konto von einem Benutzerkonto unterscheiden, was TL-Script nicht konnte: accountIsAnonymous() (AccountFunctions in tl-model-search) liefert diese Antwort für jedes Konto, daher ist currentUser().accountIsAnonymous() der Test.
Abschnittsbezeichnungen
Sektions-/Gruppenbezeichnungen fehlen. Die Sprach- und Themenauswahl sollten „Sprache“ und „Thema“ oder „Erscheinungsbild“ als Bezeichnung für die Sektion erhalten.
Ein Menü trennt seine Gruppen lediglich durch eine Linie und sonst nichts, sodass der Leser die Sprachen und Designs anhand ihrer Einträge erkennen muss. Eine Menügruppe kann nun eine Überschrift tragen:
- „ContextMenuContribution“ erhält eine optionale Bezeichnung; „ContextMenuOpener“ gibt diese als „MenuEntry“ eines neuen Typs „Überschrift“ am Anfang des Beitrags aus, nach dem Trennzeichen und nur dann, wenn der Beitrag sichtbare Einträge enthält.
- TLMenu rendert die Überschrift als nicht fokussierbare, nicht auswählbare Beschriftung (kein Menüelement; von der Tastaturnavigation ausgeschlossen).
- „AbstractMenuElement.Config.CommandGroup“ erhält eine Beschriftung (ResKey), ebenso wie „ViewCommandSource.Config “. <language-commands> und <theme-commands> setzen ihre Bezeichnungen standardmäßig auf „Language“ / „Sprache“ und „Theme“ / „Theme“, sodass jedes Menü, das diese Quellen verwendet, die Überschriften erhält, ohne sie selbst schreiben zu müssen; eine Ansicht überschreibt den Text, wenn sie davon abweicht.
Dabei festgestellt: Ein Menü, das höher ist als der Ansichtsbereich, scrollt, aber das Verschieben des Fokus mit den Pfeiltasten führte nicht dazu, dass der fokussierte Eintrag in den sichtbaren Bereich gescrollt wurde, sodass der Fokus den sichtbaren Bereich verließ. Der fokussierte Eintrag bleibt nun im sichtbaren Bereich.
Die aktive Auswahl ist markiert, nicht deaktiviert
Die aktive Sprache und das aktive Theme werden im Menü deaktiviert dargestellt. Das ist kein gutes Feedback für „aktiv“.
Die Sprach- und Theme-Quellen markierten die aktuell gültige Auswahl, indem sie deren Eintrag als nicht ausführbar darstellten, was das Menü durch Grauausblendung anzeigt – der Leser kann nicht unterscheiden, ob „das ist, was Sie haben“ oder „das ist nicht verfügbar“ gilt. Ein Befehl verfügt nun über einen expliziten aktiven Zustand, unabhängig von Ausführbarkeit und Sichtbarkeit:
- CommandModel.isActive() (Standardwert „false“) gibt an, ob die Wirkung des Befehls derzeit aktiv ist – also die aus einer Auswahl gewählte Alternative oder ein gedrückter Umschalter; SimpleCommandModel.setActive(BooleanSupplier) konfiguriert dies und wird bei jeder Anzeige wie die Ausführbarkeit ausgewertet.
- Ein Menüeintrag eines aktiven Befehls trägt die CSS-Klasse `tlMenu__item--active` sowie `aria-current="true" ` und wird fett dargestellt (`MenuEntry` erhält eine aktive Komponente, die von `ReactMenuControl` als aktiv gesendet und von `ContextMenuOpener` übergeben wird). Der Eintrag bleibt auswählbar.
- Eine Schaltfläche eines aktiven Befehls trägt die CSS-Klasse „tlReactButton--active“ und „aria-pressed“ (ReactButtonControl spiegelt den Modellzustand wider). Dies ist die Regel, die bereits für die Umschalt-Schaltfläche unter dem Namen „tlReactButtonActive“ verwendet wurde; TLToggleButton nutzt die umbenannte Klasse.
- <theme-commands> und <language-commands> kennzeichnen das aktuell gültige Design und die Sprache als aktiv; beide Einträge bleiben ausführbar. Die erneute Auswahl der aktiven Sprache bewirkt weder eine Speicherung noch ein Neuladen.
Aktionen werden mit Verben beschriftet
Bei Aktionen Verben verwenden: „Abmelden“ statt „Abmeldung“.
- Menü: „Abmeldung“ → „Abmelden“, „Anmeldung“ → „Anmelden“ (ebenso die Login-Schaltfläche oben).
- Anmeldedialog: Die Schaltfläche „Anmeldung“ → „Anmelden“; der Dialogtitel bleibt ein Substantiv.
Einstellungsdialog: Speichern und Abbrechen
Einstellungen: „Speichern“ und „Abbrechen“ statt „Schließen“.
Die eigene Schaltfläche des Dialogs wird in „Abbrechen“ umbenannt, und „Speichern“ schließt den Dialog: Die „Speichern“-Kette jeder Registerkarte wird zu <with-transaction><store-form-state/></with-transaction><close-dialog/> (Registerkarte „Basis-Konto“ in settings-tabs.view.xml und das Overlay der Registerkarte „Profil“ in tl-layout-view-contact). Da „Speichern“ den Dialog schließt, entsprechen die beiden Schaltflächen dem üblichen Paar eines Formulardialogs. Auf der Registerkarte „Sicherheit“, die eher Aktionen als Felder enthält, schließt „Abbrechen“ lediglich den Dialog.
Einstellungen > Sicherheit: kein Status des zweiten Faktors
Kein Status bei 2FA/Multi-FA-Authentifizierung. Lösung: Beschriftung / Statuszeile.
Die Registerkarte bietet die Optionen „Einrichten“ oder „Deaktivieren“ und lässt den Leser den Status anhand der angezeigten Schaltfläche ableiten. Eine Statuszeile über den Schaltflächen gibt Auskunft: „Zwei-Faktor-Authentifizierung: aktiv“ / „nicht aktiv“; ein <switch> über dem Konto prüft, ob ein Geheimnis gespeichert ist – dieselbe Bedingung, die entscheidet, welche Schaltfläche angeboten wird. Es wird kein Datum erfasst, daher bleibt das Modell unverändert.
Einstellungen > Profil: einheitliche Bezeichnungen
„Nachname“ statt „Name“; „Telefon“ und „Mobil“ vollständig ausschreiben.
- Das Profilformular beschriftet das Namensfeld mit „Last name“ / „Nachname“ über die feldspezifische Beschriftung (FieldElement.Config); die Modellbeschriftung bleibt „Name“, da Contacts:Contact#name die Unternehmensbezeichnung für einen Unternehmenskontakt ist.
- Die Modellbezeichnung von „Contacts:Contact.Person#phone_mobile“ ändert sich von „Tel. mobil“ / „Phone, cellular“ zu „Telefon mobil“ / „Mobile phone“ in „model.Contacts.messages_*.properties“ von „com.top_logic.contact“; bei „Phone“ steht bereits „Telefon“.
Bestätigungsdialog bietet „Maximieren“ an
Bestätigungsdialog (z. B. persönliche Einstellungen zurücksetzen): An dieser Stelle ist das Maximieren des Dialogs nicht erforderlich.
„ConfirmDialogControl“ erstellt sein „ReactWindowControl“ mit der Standardeinstellung „resizable=true“, und „TLWindow“ zeigt bei jedem anpassbaren Fenster die Schaltfläche „Maximieren“ an. Da es sich bei einer Bestätigung um einen Dialog mit fester Größe handelt, setzt das Steuerelement „resizable=false“, wodurch die Schaltfläche und die Größenänderungsgriffe ausgeblendet werden.
Die Zeitzone darf nicht leer sein
Die Zeitzone eines Kontos ist für jedes Datum erforderlich, das der Benutzer sieht, und tl.accounts:Person#timezone verfügt über einen Standardwert-Provider und ist daher als Pflichtfeld gekennzeichnet (Modell sowie „update-property“-Migration Ticket_29540_mandatory_timezone, wie in Ticket_29512_mandatory_model_attributes.migration.xml). Eine obligatorische Einzelauswahl bietet keinerlei klare Affordanz; die eigenen „Löschen“-Schaltflächen des Auswahlfelds sind Gegenstand von #29541.
Überprüfung
Im Browser in der React-Demoanwendung (tl-demo-react) auf Deutsch und Englisch überprüft: Die anonyme App-Leiste zeigt die Schaltfläche „Anmelden“ und keinen Avatar oder Menü an; im angemeldeten Zustand listet das Menü „Abmelden“, die Kontengruppe sowie „Sprache“ und „Theme“ als Beschriftungen über den entsprechenden Einträgen auf, die mit den Pfeiltasten übersprungen werden können; die aktuelle Sprache und das aktuelle Theme sind die einzigen fettgedruckten Einträge ihrer Gruppen, sie sind aktiviert, und ihre erneute Auswahl schließt das Menü ohne Neuladen, während die Auswahl eines anderen Eintrags die Markierung wechselt und verschiebt; „Speichern“ schließt den Einstellungsdialog und der gespeicherte Wert bleibt erhalten; die Registerkarte „Sicherheit“ zeigt den Status der Zwei-Faktor-Authentifizierung an; die Profilbezeichnungen lauten „Nachname“, „Telefon“ und „Handy“; der Bestätigungsdialog hat keine Schaltfläche zum Maximieren; das Zeitzonenfeld hat keine Schaltfläche zum Löschen, nachdem die Migration auf einer bestehenden Datenbank durchgeführt wurde; keine Konsolen- oder Serverfehler. Unit-Tests decken den aktiven Zustand bei „ContextMenuOpener“ und „ReactButtonControl“ ab.
Migration
Das Verhalten hat sich geändert, eine Codeänderung ist nicht erforderlich.
- tl.accounts:Person#timezone ist ein Pflichtfeld. Bestehende Datenbanken werden gemäß Ticket_29540_mandatory_timezone migriert; das Attribut hat einen Standardwert, sodass kein Konto ohne einen Wert bleibt. Code, der die Zeitzone eines Kontos auf null setzt, schlägt nun bei der Validierung fehl.
- Ein Menü steht an der Spitze einer Gruppe, die von <language-commands> oder <theme-commands> bereitgestellt wird, mit den Überschriften „Sprache“ / „Design“. Eine Anwendung, die andere Überschriften wünscht, setzt <label> in der Quelle oder lässt es weg, indem sie es auf einen leeren Schlüssel setzt.
- Der Kontobereich von „user-menu.view.xml“ zeigt bei einer anonymen Sitzung weder einen Avatar noch ein Menü an, sondern nur die Schaltfläche „Anmelden“. Ein Overlay, das Einträge für anonyme Benutzer bereitstellt, muss diese an anderer Stelle platzieren.
- Die Einträge des aktuell aktiven Designs und der aktuellen Sprache sind aktiviert und fett markiert; zuvor waren sie deaktiviert.
Die Signaturen wurden geändert. „ViewCommandSource“ erhielt die Methode „getLabel();“; eine Implementierung außerhalb der Engine muss diese implementieren (und bei fehlender Überschrift „null“ zurückgeben). ContextMenuContribution hat einen Konstruktor mit drei Argumenten erhalten; der Konstruktor mit zwei Argumenten bleibt unverändert. CommandModel hat isActive() mit dem Standardwert „false“ erhalten, sodass Implementierungen keine Änderung erfordern. Der Datensatz ReactMenuControl.MenuEntry hat eine aktive Komponente erhalten; Code, der Einträge über den Datensatzkonstruktor oder die Factory-Methode item(...) mit fünf Argumenten erstellt, übergibt diese. Ein Theme-Styling „tlReactButtonActive“ zielt auf „.tl-button[aria-pressed="true"]“ ab (#29617 hat die „tlReactButton*“-Klassen entfernt).
Die Beschriftungen wurden geändert. Skriptgesteuerte Tests, die sich auf die Beschriftungen „Abmeldung“, „Anmeldung“ oder „Tel. mobil“ beziehen, müssen nun „Abmelden“, „Anmelden“ und „Telefon mobil“ verwenden.