Ziel
Eine auf der Ebene „com.top_logic.layout.view“ basierende Anwendung muss ihren Kontobereich in der App-Leiste manuell zusammenstellen: ein <derived-channel expr="currentUser()">, ein <avatar> in den <children> der Leiste und eine einzelne Schaltfläche mit der Platzierung „TOOLBAR“ pro Kontoaktion. Die Consulting-Anwendung tut genau das und ergänzt dies durch CSS, das die Schaltflächen anhand ihrer Symbolgrafik auswählt, da kein befehlsspezifisches Styling das DOM erreicht.
Der Kontobereich wird hier als Kernansicht bereitgestellt, auf die eine Anwendung verweist, und durch ein Overlay auf demselben Pfad erweitert – so wie es bereits bei der Verwaltungsansicht der Fall ist. Was ein Benutzer mit einer einzigen Entscheidung ändert, ist ein Eintrag in diesem Menü; was ein Formular erfordert, ist ein Dialog, den das Menü öffnet. Alles, was dabei anliegt, wird hier behandelt.
Ein Benutzermenü, zusammengestellt statt erstellt
Ein früherer Versuch (Ticket #29108) fügte ein maßgeschneidertes `UserMenuElement` mit eigenem `UserMenuControl` und der React-Komponente `TLUserMenu` hinzu und wurde im selben Ticket zurückgezogen, da er Formulare und Schaltflächen neu implementierte, die die Ansichtsebene bereits zusammensetzt. Das Konzept kehrt nun als Zusammensetzung bestehender Teile zurück:
- WEB-INF/views/user-menu.view.xml in tl-layout-view, das einen eigenen „currentUser“-Kanal deklariert, sodass eine Anwendung das Menü mit einem einzigen <view-ref view="user-menu.view.xml"/> in die App-Leiste einfügt und keine Verknüpfungen vornehmen muss.
- Eine Anwendung fügt Einträge hinzu, verschiebt sie oder entfernt sie mithilfe eines Overlays mit demselben Pfad, das vom ViewLoader in der Reihenfolge der Abhängigkeiten zusammengeführt wird, da tl-model-search-react bereits admin/admin.view.xml erweitert. Das Kernmodul benötigt keine Kenntnisse über den Mitwirkenden.
Die Einträge sind „Anmelden“ (nur anonym), „Passwort ändern“, „Einstellungen“ und „Abmelden“ (nur für authentifizierte Benutzer) sowie jeweils einer pro Sprache und einer pro Design.
Ein generischer Menüträger
ContextMenuElement wandelt die darin deklarierten Befehle bereits in ein Popup um, filtert sie nach Sichtbarkeit, gruppiert sie nach Cliquen und leitet die Auswahl weiter – allerdings nur über ein ContextMenu-Ereignis über den Inhalt, den es umschließt. Das einzige fehlende Teil ist ein Menü, das durch Klicken auf einen Trigger geöffnet wird.
Anstatt einer zweiten Implementierung wurde der Teil von „ContextMenuElement“, der für den Aufbau von Beiträgen zuständig ist, in „AbstractMenuElement“ ausgelagert, und „ContextMenuRegionControl“ wurde zusammen mit „TLContextMenuRegion“ zu „MenuRegionControl“ bzw. „TLMenuRegion“, parametrisiert durch einen „MenuTrigger“: „contextmenu“ platziert das Menü an der Mausposition, ein Klick verankert es unterhalb des Begrenzungsrahmens der Region. Beide melden die Viewport-Koordinaten, an denen das Menü erscheint, sodass ContextMenuOpener keine Änderung benötigte.
Das neue <menu> -Element bezieht seinen Trigger aus seinen untergeordneten Elementen – dieselbe „content“-Eigenschaft, die <context-menu> für seinen Rechtsklick-Bereich verwendet –, sodass die beiden Elemente die gleiche Form haben und sich nur in der Geste unterscheiden. Jeder innerhalb eines <menu> deklarierte Befehl wird zu einem Eintrag, unabhängig von seinem `CommandPlacement`: Ein in einem Menü geschriebener Befehl ist per Definition ein Eintrag dieses Menüs, weshalb `CommandPlacement ` keinen neuen Wert benötigt.
Ein Menü bildet einen Beitrag pro Gruppe von Einträgen statt einer flachen Liste, da „ContextMenuOpener“ die Einträge eines Beitrags von denen des nächsten trennt. Die in der Ansicht geschriebenen Befehle bilden eine Gruppe und jede Befehlsquelle eine andere; daher werden die Kontoaktionen, die Sprachen und die Designs durch Trennzeichen voneinander getrennt, und eine Gruppe, die nichts zu bieten hat, fällt zusammen mit ihrem Trennzeichen weg.
Zur Laufzeit abgeleitete Befehle
Um ein Menü aus dem Status statt aus der Konfiguration zu speisen, war eine Schnittstelle erforderlich: „ViewCommandSource“ ist eine konfigurierte Befehlsquelle, deren Anzahl und Identität erst zur Laufzeit bekannt sind; sie wird über die Eigenschaft <command-sources> eines Menüs bereitgestellt und an die deklarierten Befehle angehängt. Zwei davon werden angeboten.
<theme-commands> liefert einen Eintrag pro in UIThemeService konfiguriertem Design, der vom Design selbst beschriftet und mit einem Symbol versehen wird, wobei das aktive Design als deaktiviert dargestellt wird – was sowohl dessen Bedeutung widerspiegelt als auch die Art und Weise, wie das Menü anzeigt, welches Design gerade aktiv ist. UITheme erhält eine Icon- Eigenschaft, da das Theme selbst weiß, wie es aussieht, und SetThemeCommand stellt „applyTheme“ bereit, sodass die Quelle die Aktivierung wiederverwendet, anstatt sie zu kopieren. Ein einzelnes `SetThemeCommand ` kann dies nicht leisten: Es benennt eine statische Theme-ID, sodass eine Ansicht, die es verwendet, jedes ihr bekannte Theme einzeln auflisten muss und niemals erkennen kann, welches aktiv ist.
<language-commands> liefert einen Eintrag pro unterstützter Locale des ResourcesModule, der mit dem Namen der Sprache in dieser Sprache gekennzeichnet ist – „Deutsch“, „English“ –, was ein Leser, der nach seiner Sprache sucht, erkennt und wofür keine eigene Übersetzung erforderlich ist. Im Gegensatz zu einem Theme kann eine Sprache nicht auf eine gerenderte Seite angewendet werden; daher speichert der Schalter sie im Konto, teilt dies der Sitzung mit und lädt die Seite neu. Keine der beiden Quellen bietet etwas an, solange nur eine Auswahlmöglichkeit besteht, und die Sprachquelle bietet einer anonymen Sitzung nichts an, da diese über kein Konto verfügt, in dem eine Auswahl gespeichert werden könnte.
Ein Passwort wird auf beiden Seiten auf dieselbe Weise geändert
ChangePasswordApplyAction las das zu ändernde Konto aus LoginAction#ACCOUNT_CHANNEL aus und endete stets mit dem Aufruf von LoginAction.proceedAfterPassword, sodass change-password.view.xml nur eine Anmeldung fortsetzen konnte. Die Kopplung war zufällig: Die klassische ChangePasswordComponent ändert das Passwort einer Person, ohne dass gerade eine Anmeldung läuft.
Das Konto greift nun auf das der Sitzung selbst zurück, wenn keine Anmeldung ansteht, und nur eine ausstehende Anmeldung – was durch das Vorhandensein dieses Kanals signalisiert wird – wird anschließend fortgesetzt. „change-password.view.xml“ zeigt den Hinweis „Ihr Passwort ist abgelaufen“ nur auf diesem Pfad an, und zwar über ein <switch> -Element für den Account-Kanal, und ist somit ein einziger Dialog, der beide Fälle abdeckt.
Persönliche Einstellungen
WEB-INF/views/settings.view.xml ist ein Formular über das Konto, das das enthält, was ein einzelner Menüeintrag nicht ausdrücken kann: die Zeitzone und das Land. Es bezieht sich auf tl.accounts:Person, sodass das Ansichtsmodul nichts vom „Kontakte“-Modell benötigt; ein Modul, das über dieses verfügt – oder die Anwendung selbst –, stellt die Profilfelder über ein Overlay auf demselben Pfad bereit, wie es tl-layout-view-contact tut.
Ein Benutzer richtet hier auch seinen eigenen zweiten Authentifizierungsfaktor ein und kann ihn wieder entfernen – und zwar im selben Registrierungsdialog, den der Anmeldeablauf verwendet. Das Konto behält seine Anforderungen bei, da ein vom Benutzer gewählter Faktor wieder entfernt werden kann; jede Schaltfläche wird nur in dem Zustand angeboten, in dem sie eine Bedeutung hat – was davon abhängt, ob ein Geheimnis gespeichert ist.
Der Kontobereich schließt die App-Leiste
Der Kontobereich wurde unter den Inline-Unterelementen der Leiste platziert, wodurch er rechts vom Titel und links von allem anderen lag. Sein richtiger Platz ist jedoch am anderen Ende, hinter den Schaltflächen der in der Symbolleiste angeordneten Befehle – und die Leiste hatte keine Möglichkeit, dies auszudrücken: Ihr Aktionsbereich besteht aus Befehlen, und ihr vorderer Bereich ist das falsche Ende.
Eine App-Leiste nimmt nun neben ihrem <leading> -Bereich einen <trailing> -Bereich ein, und beide sind auf dieselbe Weise aufgebaut, da eine App-Leiste horizontal verläuft und mehrere Elemente an einem ihrer Enden nebeneinander statt übereinander angeordnet sind – was bei einer generischen Inhaltskombination der Fall wäre. Ein Aktionsbereich vor dem hinteren Bereich hat den freien Platz bereits beansprucht, sodass der hintere Bereich ihn nicht ein zweites Mal beansprucht und die Befehlsschaltflächen in der Mitte der Leiste zurücklässt.
Eine Schaltflächenleiste im Einstellungsdialog
Die Registerkarte „Konto“ hat ihr Formular in ein <panel> eingebettet, um die Schaltfläche „Speichern“ von den anderen Registerkarten fernzuhalten, wodurch diese Registerkarte neben der des Dialogs eine eigene Schaltflächenleiste erhielt – „Speichern“ in der einen, „Schließen“ in der anderen – und die Registerkarte „Profil“ von tl-layout-view-contact tat dasselbe. Ein Formular stellt seine Befehle nur so lange dem umgebenden Bereich zur Verfügung, wie es angezeigt wird, und eine Registerkarte, die nicht aktiv ist, wird nicht angezeigt; daher verschwinden die Panels und „Speichern“ wird zusammen mit „Schließen“ in die einzige Leiste integriert, über die der Dialog bereits verfügt.
Dies gilt jedoch nur, wenn das Formular zum Zeitpunkt der Erstellung der Leiste bereits existiert. ReactTabBarControl erstellte den Inhalt seiner aktiven Registerkarte beim ersten Schreibvorgang; zu diesem Zeitpunkt war die umgebende Schaltflächenleiste bereits ohne diesen Inhalt gerendert worden: „Speichern“ erschien erst, nachdem man die Registerkarte verlassen und wieder zurückgekehrt war. Der Inhalt wird nun beim Anheften der Registerkartenleiste erstellt, noch vor dem Rendern, wo die dem Hook folgende Anheftungsausbreitung ihn erreicht.
Die Registerkarte „Sicherheit“ listet Schaltflächen statt Felder auf, sodass nichts den Abstand mitbrachte, den ein Formular von sich aus mit sich trägt, und die Schaltflächen an den Rand des Dialogfelds geklebt wurden. Ein <inset> verleiht der Liste denselben Seitenabstand, sodass beide Registerkarten ihren Inhalt im gleichen Abstand dazu halten.
Das Verlassen der Sitzung steht im Konto-Menü für sich
Ein Menü zeichnet eine Trennlinie zwischen den Gruppen von Einträgen, aus denen es besteht, und alles, was eine Ansicht geschrieben hat, bildete eine Gruppe: Der Eintrag zum Verlassen befand sich direkt über den Einträgen zum Einloggen. Ein Menü nimmt nun über eine <groups> -Eigenschaft weitere Gruppen nach den in <commands> geschriebenen Einträgen auf, wobei jede Gruppe von der vorherigen abgesetzt ist.
Dies ist der Mechanismus, zu dem das Trennzeichen bereits gehört, und nicht ein Eintrag, der eine Linie zeichnet: Eine Gruppe, deren Einträge derzeit nicht verfügbar sind, wird zusammen mit ihrem Trennzeichen weggelassen, sodass sich das Konto-Menü einer anonymen Sitzung – das „Anmelden“ und sonst nichts aus der ersten Gruppe anbietet – weiterhin ohne eine Linie darüber oder darunter öffnet. Das Konto-Menü ordnet das Anmelden und Abmelden der ersten Gruppe zu und die Daten des Kontos der zweiten; die beiden Richtungen bilden eine Gruppe, da jeweils genau eine davon angeboten wird.
Eine Sprache und ein Land unter ihrer jeweiligen Flagge
Die Sprachen im Konto-Menü wurden bisher allein anhand ihrer Namen unterschieden, und das Länderfeld umfasste 249 Zeilen Text. Jede Sprache wird nun durch eine Flagge dargestellt.
Die Bilder stammen aus dem Stylesheet „flag-icons“, das von einem Webjar bereitgestellt wird und pro ISO 3166-1-Ländercode sowie einige darüber hinausgehende Symbole enthält: die Flagge einer Region, einer Union und eines Sprachraums, der kein Land ist. Eine Flagge ist daher ein gewöhnliches CSS-Klassen-Symbol und benötigt keine eigene Infrastruktur.
Ein Land ist ein ISO-3166-1-Code, daher benötigt seine Flagge keine Konvention – nur einen Ressourcenanbieter, der dies festlegt. Für den Typ war überhaupt keine registriert, sodass der Standardwert zum Tragen kam, dessen Bezeichnung für ein Land die Debugging-Form des Objekts ist; das Kontaktmodul glich dies durch einen Anbieter aus, dessen gesamter Inhalt darin bestand, ein Land mit seinem Namen zu bezeichnen. Diese Beschriftung übernimmt nun com.top_logic.util.CountryResourceProvider neben dem Typ, sodass ein Anbieter sowohl für die Bezeichnung als auch für die Flagge zuständig ist.
Welche Flagge für eine Sprache steht, ist eher eine Konvention als eine Tatsache und somit eine Konfiguration: „LanguageFlags“ legt dies für die bekannten Sprach-Tags fest – die Flagge des Landes, mit dem die Sprache am stärksten assoziiert wird, die Flagge des Gebiets, in dem sie gesprochen wird, wenn kein einzelnes Land dafür zuständig ist, und die Fallback-Flagge, wenn keines der beiden zutrifft. Eine Anwendung, die damit nicht einverstanden ist, überschreibt den Eintrag, mit dem sie nicht einverstanden ist. Einträge werden nach ihrer Spezifität sortiert, d. h. eine Region trägt nur dann ihre eigene Flagge, wenn die Anwendung diese Region als eigenständige Sprache unterstützt. Eine Sprache, die von keinem Eintrag abgedeckt wird, erhält die Fallback-Flagge statt gar nichts: Eine Liste, in der einige Einträge eine Flagge tragen und andere nicht, liest sich schlechter als eine, in der alle eine haben.
Beide befinden sich neben dem Ländertyp und nicht in der Ansichtsebene, sodass alles, was irgendwo eine Sprache oder ein Land darstellt, dessen Flagge benennen kann.
Eine Sitzung beginnt dort, wo der jeweilige Benutzer beginnt
Durch das Einloggen wurde die Sitzung auf der Seite fortgesetzt, die zuvor aufgerufen worden war. Die Weiterleitung, die den Sitzungswechsel durchführt, verweist zurück auf die URL, über die die Anfrage eingegangen ist, und eine URL, die eine Seite benennt, fordert diese Seite an – daher kam die Startseite des sich einloggenden Benutzers nie zum Tragen, da die Navigation eines anderen die Frage bereits für ihn beantwortet hatte.
Eine Sitzung, die gerade eine andere abgelöst hat, wird als solche gekennzeichnet, und ihre erste Ansichtsanfrage lässt die Route fallen, die die URL noch enthält. Die Seite stammt dann von der Startseite desjenigen, der die Sitzung übernommen hat, oder vom Standard der Anwendung, wenn keine ausgewählt wurde. Das Abmelden ist derselbe Wechsel in die andere Richtung und wird auf dieselbe Weise behandelt.
Fehler: Eine Option eines Dropdown-Menüs konnte kein Bild enthalten
Ein Dropdown-Menü fragte seinen Label-Provider nach dem Bild einer Option und ließ es weg, es sei denn, dieser Provider war zufällig ein ResourceProvider – was bei dem übergebenen Provider jedoch niemals der Fall ist. Der Client hat das Bild einer Option die ganze Zeit über mitgeführt – sowohl in den Optionszeilen als auch in den Chips und den schreibgeschützten Werten –, doch auf keines davon konnte jemals zugegriffen werden: Ein Select-Element wird mit dem Meta-Label-Provider erstellt, sodass der Zweig, der das Bild schrieb, für jedes Dropdown-Menü in der Anwendung unwirksam war. Der übergebene Provider ist nun der ResourceProvider, der sowohl für ein Bild als auch für eine Beschriftung zuständig ist; die beiden Register des „LabelProviderService“ greifen gegenseitig auf einander zurück, sodass ein Typ, der nur für seine Beschriftung registriert ist, genau wie zuvor beschriftet wird.
Dabei stieß das Bild auf zwei Probleme: In beiden Fällen erreichte die kodierte Form einen Leser, der sie nicht lesen konnte. Das Bild wurde, anders als das eines Buttons, ohne Auflösung kodiert, sodass eine Referenz – das Icon, das ein Theme für einen Typ konfiguriert – als Referenz ankam, für die der Client kein Theme zum Nachschlagen hatte, und die gesamte kodierte Zeichenkette wurde zu einer CSS-Klasse: einer, die einen Doppelpunkt enthielt und nichts benannte. Und das unsichtbare Bild wird als eigenständiges Formular kodiert, das zu einem Element wurde, das eine Klasse trägt, die nichts zeichnet und dennoch die Breite eines Symbols einnimmt, sodass jede Option einer Aufzählung durch ein Symbol eingerückt wurde, das sie gar nicht besitzt. Es wird nun gänzlich aus dem Deskriptor weggelassen, und beide Decoder des Clients antworten darauf mit nichts statt mit einem Element – es gehört zum Vokabular, das sie dekodieren, und einer von ihnen hat es dokumentiert, während er auf seinen CSS-Klassen-Fallback zurückgriff. Das Dropdown-Menü liest das Bild einer Option zudem über den Decoder, den die Schaltflächen, die Menüs und die Seitenleiste verwenden, und nicht über den, der zwei der Präfixe kannte.
Fehler: Die kommandospezifische Darstellung erreicht die Schaltfläche nicht
ViewCommand.Config deklariert CSS-Klassen, die als zusätzliche CSS-Klassen dokumentiert sind, die auf das UI-Element des Befehls angewendet werden sollen. Es wird geparst, es überlebt die Instanziierung, und ViewCommandModel macht es verfügbar – und nichts liest es. Das React-CommandModel, das von „ReactButtonControl“ serialisiert wird, enthält kein entsprechendes Element, sodass kein Status-Schlüssel geschrieben wird und der Client nichts anwenden kann. Ein View-Autor, der einen Befehl über die Eigenschaft stylt, erhält weder eine Fehlermeldung noch eine Warnung, und es tritt keine Wirkung ein. Gemeldet für 8.0.0-alpha7 durch die Consulting-Anwendung, deren Feststellung, dass destruktive Aktionen besser gekennzeichnet werden sollten, genau dem Zweck der Eigenschaft entspricht; sie umgeht die Lücke mit
{{{#!css .tlReactButton:has(> .bi-trash) { color: var(--text-error); } }}}
einer manuell festgelegten Konvention, die stillschweigend die Überlagerung eines Löschbuttons mit einem anderen Symbol beendet und stillschweigend die Überlagerung eines harmlosen Befehls mit dem Papierkorb-Symbol startet.
„display“ ist aus einem enger gefassten Grund auf demselben Pfad unwirksam. ToolbarBuilder berücksichtigt CommandModel#getDisplayMode(), sodass „display=“icon-only““ auf einer Panel-Symbolleiste funktioniert; die App-Leiste erstellt ihre Aktionsschaltflächen selbst in „AppBarElement“, direkt über „new ReactButtonControl(context, model)“, und ist daher der Pfad, auf dem dies versagt.
Beiden fehlt ein Aspekt: Der Konstruktor, der eine Schaltfläche aus einem CommandModel verknüpft, synchronisiert Beschriftung, Ausführbarkeit, Sichtbarkeit, Bild, Tooltip und Tasten-Geste, jedoch keine der beiden verbleibenden Darstellungseigenschaften. Die Korrektur gehört dorthin und nicht in die App-Leiste, damit alle Aufrufstellen auf einmal abgedeckt werden. Ein Container trägt nun nur noch seinen Standardwert bei, und zwar über `ReactButtonControl#setDefaultDisplayMode`, was für einen Befehl gilt, der keinen eigenen Modus anfordert – wodurch die Überprüfung „nur Symbol ohne Bild“ an einer Stelle zusammengefasst und einmalig gemeldet wird, und zwar als Autorfehler bezüglich dieses Befehls und nicht als Fehler des Container-Standardwerts, der zufällig nicht dazu passt. Ein „MenuEntry“ enthält die Klassen ebenfalls, sodass sich die Eigenschaft bei einem Befehl, der als Menüeintrag gerendert wird, genauso verhält.
Fehler: Ein gerenderter Menüeintrag hatte kein Symbol
TLMenu fügte das Symbol eines Eintrags in die von ContextMenuOpener erzeugte, kodierte Form eines Klassenattributs ein. Bei „css:bi bi-sun“, was die beiden Klassen „css:bi“ und „bi-sun“ ergibt, wurde die eigene Basisklasse der Icon-Schriftart weggelassen, sodass kein Icon gerendert wurde; ein Eintrag vom Typ „/icons/...“ oder „theme:...“ rendert ebenfalls nichts. Menüeinträge durchlaufen nun ThemeIcon, das die Form dekodiert, wie es bei Schaltflächen bereits der Fall war. Jedes Kontextmenü in der Anwendung war davon betroffen, nicht nur das neue.
Fehler: Der Text auf der Akzent-App-Leiste war unlesbar
Ein Textelement bringt die primäre Textfarbe mit, die fast schwarz ist, und die Akzentleiste, auf der es sich befindet, ist dunkelgrau: Der Kontoname neben dem Avatar war bei einem hellen Design nicht lesbar. Die Leiste ordnete Vordergrundfarben bereits ihrer Akzentfarbe zu, doch für eine bestimmte Klasse wurde nichts mehr erzeugt – der Kontobereich ist ein Menübereich, während die Regel weiterhin das Element benannte, das sie ersetzte. Nun passt sie zu den tatsächlich gerenderten Textelementen, sodass jeglicher Text, der auf der Leiste angezeigt wird, lesbar ist. Der Kontobereich wurde außerdem in der generischen hellen Hover-Farbe angezeigt, wodurch der Text in der Akzentfarbe unlesbar war, sobald man mit der Maus darauf zeigte; auf der Akzentleiste wird er nun im Hover-Modus in den eigenen, dunkleren Farbtönen des Akzents dargestellt.
Fehler: Ein Overlay war bei einem dunklen Design nicht von der Seite zu unterscheiden
Ein über der Seite schwebendes Popup wurde in der Oberflächenfarbe der Seite dargestellt, mit einem dezenten Rand umrandet und mit einem „rgba“-Wert beschattet, den das Design gar nicht kannte. Bei einem hellen Design ist das noch akzeptabel; bei einem dunklen Design unterscheiden sich das Popup und die dahinterliegende Seite um vier Graustufen, und der Schatten ist unsichtbar, sodass ein Menü keine erkennbaren Ränder hatte.
Popups übernehmen nun die hervorgehobene Oberfläche, den starken Rahmen und den themeneigenen Menuschatten – ein Merkmal, das konfiguriert, aber nicht genutzt wurde. Die hervorgehobene Oberfläche entspricht bei einem hellen Design der der Seite, sodass sich dort nichts ändert. Dies gilt für das Menü, das Dropdown-Menü der Symbolleiste, das Gruppen-Flyout der Seitenleiste und die Optionsliste eines Feldes, wobei letztere die Feldfarbe beibehält, die sie mit dem zugehörigen Eingabefeld teilt; die Konvention ist neben dem Abstandsmodell festgehalten und nicht in jeder einzelnen Regel.
Fehler: Jedes Bild wurde als Foto angekündigt
Das Bildelement verkündete alles, was es anzeigte, als „Fotografie“ – der Fall, für den der zugrunde liegende Fotobetrachter geschrieben wurde. Der QR-Code zur Registrierung eines Authentifikators ist keine Fotografie, und ein Leser, der ihn nicht sehen kann, erfährt nichts, wenn ihm gesagt wird, dass es sich um eine solche handelt. Ein Bildelement akzeptiert nun einen Alt-Text, den der Fotobetrachter seinem eigenen Standardwert vorzieht; wird dieser nicht festgelegt, gilt der Standardwert.
Fehler: Eine Basisansicht, die eine Overlay-Operation benannte, konnte nicht geladen werden
ViewLoader stufte eine Ansicht als Overlay-Fragment ein, indem es den Rohdateitext nach „config:operation“ durchsuchte. Daher wurde eine Basisansicht, die dieses Attribut in einem Kommentar nannte, als Overlay ihrer selbst interpretiert, hatte keine Basis, auf der sie aufbauen konnte, und jeder Dialog, der sie öffnete, schlug fehl – ohne Fehlermeldung, da auf diesem Pfad kein ErrorSink verfügbar war, was einen toten Menüeintrag hinterließ. Genau das tat „settings.view.xml“, indem es in seinem eigenen Header das Overlay dokumentierte, dessen Erstellung von Mitwirkenden erwartet wurde. Die Entscheidung erfolgt nun anhand des geparsten Dokuments, wobei nur ein tatsächliches Attribut im Konfigurations-Namespace zählt, das über die vorhandenen „ConfigurationSchemaConstants“ benannt wird.
Fehler: Eine Sprachänderung wurde in der laufenden Sitzung nicht übernommen
Beim Ändern der Sprache wurde die Auswahl gespeichert und hatte bis zur nächsten Anmeldung keine sichtbare Auswirkung – weshalb die klassische Benutzeroberfläche überhaupt keine Möglichkeit zum Wechseln bietet, sondern nur ein Formularfeld, das erst bei der nächsten Anmeldung wirksam wird. Zwei Ebenen waren dafür verantwortlich.
„Resources“ speichert die Bundles einer Locale in der Untersitzung im Cache und verwendet sie wieder, solange isValid() wahr ist – und dabei wird ein Neuladen des „Resources“-Moduls verfolgt, nicht die Locale, mit der die Sitzung gestartet wurde. Daher lieferte eine Sitzung weiterhin Antworten aus den Bundles, mit denen sie gestartet wurde, und setCurrentLocale änderte nichts daran. Der zwischengespeicherte Wert besteht aus den Bundles einer bestimmten Locale, sodass die Cache-Prüfung nun auch die Locale validiert. Nur „Resources“ selbst schreibt diesen Cache, und zwar in `getInstance` und in `withLocale`, und beide speichern die Bundles der aktuellen Locale der Untersitzung, sodass die Prüfung dem entspricht, was der Cache bereits bedeutete.
Dadurch blieben allein alle Elemente erhalten, die nach einem darauf folgenden Wechsel erstellt wurden – ein Dialog, eine Snackbar, die eigenen Strings des Clients –, während die Beschriftungen des bereits auf dem Bildschirm angezeigten Baums unverändert blieben: Ein Steuerelement löst seine Beschriftungen bei der Erstellung auf, und ein Neuladen rendert den Baum, den die Registerkarte noch enthält, anstatt einen neuen aufzubauen. Ein gerenderter Baum ist daher eine Darstellung einer Ansicht in einer Sprache, was „RenderedView“ nun erfasst: Die Wiederverwendungsprüfung vergleicht die Locale neben dem Ansichtspfad mit der des geladenen Elements, sodass eine Sprachänderung zu einer Neugenerierung führt, während ein gewöhnliches Neuladen das beibehält, was der Benutzer erstellt hat. Der Verlust der Scrollposition bei einer Sprachänderung ist der Punkt, an dem sich diese beiden Interessen trennen.
ViewServlet schrieb außerdem „lang="en"“ in das Dokument, unabhängig davon, wie die Seite gerendert wurde; nun wird die Sprache angegeben, in der die Seite tatsächlich gerendert wird.
Fehler: Eine Registerkarte wurde in der Sprache beschriftet, in der die Ansicht zuerst geladen wurde
„TabBarElement“ und „BottomBarElement“ ermittelten ihre Beschriftungen im Konstruktor. Ein Element wird einmal geparst und für die gesamte Laufzeit der JVM zwischengespeichert, wobei dieser Speicher von allen Sitzungen gemeinsam genutzt wird. Daher entsprach der Text der Sprache der Sitzung, die die Ansicht zufällig zuerst geladen hatte – die Registerkarten der Demo wurden einem englischsprachigen Nutzer auf Deutsch angezeigt, und kein Sprachwechsel konnte dies ändern. Die Einträge behalten den ResKey bei und lösen ihn dort auf, wo SidebarElement dies bereits tat, nämlich wenn ein Steuerelement für die gerade bediente Sitzung erstellt wird.
Fehler: Ein Wechsel der Sidebar-Einträge ergab eine URL, die zu keiner Seite führte
Die Seitenleiste meldete den neuen Eintrag, bevor die verlassene Seite getrennt wurde; daher war zwischen den beiden der Routing-Teilnehmer der alten Seite – die Registerkartenleiste, die die angezeigte Registerkarte benannte – noch registriert und wurde als zur neuen Seite gehörend interpretiert. Die falsche Zusammensetzung gelangte in die Adressleiste, nicht nur ins Protokoll. Die verlassene Seite erscheint nun an erster Stelle, und nichts betrachtet die beiden gemeinsam.
Überprüfung
Verifiziert im Browser anhand der React-Demoanwendung, bei der die Änderung ebenfalls von einer flachen Benutzerbezeichnung plus „Anmelden/Abmelden“-Schaltflächen in der Symbolleiste zum Benutzermenü führt.
- Anonym: Anmeldung angeboten, keine Optionen für „Passwort ändern“ / „Einstellungen“ / „Abmelden“ und keine Spracheinträge. Angemeldet: Der Kontoname und der Avatar schließen die App-Leiste ab, die Einträge sind durch Trennzeichen gruppiert in „Abmelden“, die eigenen Kontoeinstellungen, die Sprachen und die Designs – und das anonyme Menü öffnet sich ohne überflüssige Trennzeichen.
- Design: Der Wechsel erfolgt sofort ohne Neuladen, in beide Richtungen, wobei das aktive Design jedes Mal als deaktiviert angeboten wird; die Symbole der Einträge werden gerendert.
- Sprache: Die Umstellung gilt innerhalb der Sitzung in beide Richtungen ohne erneute Anmeldung – Seitenleisten-Navigation, Panel-Titel, Tabellen-Symbolleiste, Spaltenüberschriften, Menübezeichnungen und Datumsformatierung passen sich alle an, und die Auswahl bleibt auch nach einem Neuladen und einer erneuten Anmeldung erhalten. Ein einfaches Neuladen behält die Auswahl in einer Tabelle bei; nur eine tatsächliche Sprachänderung setzt sie zurück.
- Flaggen: Jeder Spracheintrag trägt eine eigene Flagge, und jede der 249 Optionen des Länderfelds trägt die Flagge des jeweiligen Landes, ebenso wie die ausgewählte Option; jeder Code wird anhand des Stylesheets aufgelöst. Die Optionen einer Aufzählung tragen kein Symbol und sind nicht um eine Einrückung versetzt, während eine Kontooption das Symbol trägt, mit dem ihr Typ konfiguriert ist.
- Einstellungen: Eine Schaltflächenleiste pro Dialogfeld, die auf den Registerkarten „Konto“ und „Profil“ neben „Schließen“ die Schaltfläche „Speichern“ und auf der Registerkarte „Sicherheit“ nur „Schließen“ enthält – sowohl in einem neu geöffneten Dialogfeld als auch nach dem Wechseln zwischen den Registerkarten; die Sicherheitsschaltflächen sind wie in einem Formular eingerückt. Zeitzone und Land bleiben für das Konto erhalten.
- Startseite: Die Anmeldung aus einer anonymen Sitzung, die sich auf einer anderen Seite befindet, führt zur Startseite des Kontos, bei dem die Anmeldung erfolgt.
- App-Leiste: Der Kontobereich schließt die Leiste sowohl bei breitem als auch bei schmalem Ansichtsbereich, wobei der Schieberegler für die Ausklappleiste an der Spitze steht und die Befehlsschaltflächen bündig an der Leiste anliegen statt in der Mitte der Leiste.
- Rechtsklick-Kontextmenüs funktionieren weiterhin, was im Baum des View Designers überprüft wurde, einschließlich der Ausführbarkeit pro Knoten.
- Durchgehend keine JavaScript-Fehler und keine serverseitigen Fehler.
Migration
Umbenannt. Eine Anwendung, die darauf verweist, muss folgendem Namen folgen:
| com.top_logic.layout.view.command.ContextMenuRegionControl | com.top_logic.layout.view.command.MenuRegionControl |
| React-Modul TLContextMenuRegion | TLMenuRegion |
| ContextMenuElement.DEFAULT_TARGET_CHANNEL | AbstractMenuElement.DEFAULT_TARGET_CHANNEL |
MenuRegionControl akzeptiert zudem eine Liste von ContextMenuContributionsanstelle eines einzelnen sowie einen MenuTrigger. Das <context-menu> -Element und seine Konfiguration bleiben unverändert, sodass keine Ansichtsdatei bearbeitet werden muss.
Entfernt. com.top_logic.contact.layout.CountryResourceProvider wurde entfernt, ebenso wie die beiden Registrierungen in der Datei contactConf.config.xml. Eine Anwendung, die auf die Klasse verweist, muss den Verweis entfernen: Ein Land wird von com.top_logic.util.CountryResourceProvider bereitgestellt, das in top-logic.config.xml registriert ist und dieselbe Bezeichnung erzeugt sowie das Länderkürzel hinzufügt. Eine Anwendung, die die entfernte Klasse für einen eigenen Typ registriert hat, muss stattdessen die neue Klasse angeben.
Signaturen wurden geändert. „ReactMenuControl.MenuEntry“ hat eine „cssClasses“-Komponente erhalten, sodass ein Aufruf seines kanonischen Konstruktors das zusätzliche Argument benötigt; die Factory-Methoden „item(...)“ und „separator()“ bleiben unverändert und stellen die vorgesehene Methode zum Erstellen eines Elements dar. UITheme verfügt nun über einen Konstruktorparameter „icon “. ReactAppBarControl verfügt nun über einen abschließenden Steuerelementparameter; die kürzeren Konstruktoren bleiben unverändert und fügen an dieser Stelle nichts hinzu.
Das Verhalten hat sich geändert, eine Codeänderung ist jedoch nicht erforderlich.
- „display“ und „css-classes“ in einem View-Befehl wirken nun überall dort, wo der Befehl gerendert wird. Bei einer Anwendung, die darauf vertraut hat, dass diese ignoriert werden, ändert sich die Darstellung der App-Bar-Schaltflächen, und eine Anwendung, die die Lücke im CSS umgangen hat (Auswahl der Schaltfläche eines Befehls anhand ihres Symbols), sollte diesen Workaround zugunsten von „css-classes“ aufgeben.
- Eine Option eines Dropdown-Menüs zeigt nun das Bild an, für das ihr Typ einen ResourceProvider registriert hat – und zwar in der Optionsliste, den Chips und der schreibgeschützten Anzeige. Bei einer Anwendung, deren Typen ein Symbol enthalten, wird dieses in jeder Auswahl angezeigt; eine Anwendung, die für einen bestimmten Typ kein Symbol wünscht, registriert dafür `ThemeImage.none()`, was als kein Symbol und nicht als leeres Symbol dargestellt wird.
- Die Sprache einer Sitzung wird nicht mehr bei der Anmeldung festgelegt. Eine Anwendung, die lokalisierungsabhängige Zustände pro Sitzung zwischenspeichert, muss diese ungültig machen, wenn sich SubSessionContext#getCurrentLocale() ändert, und eine Anwendung, die beim Erstellen eines gemeinsam genutzten Objekts (ein UIElement, ein zwischengespeichertes Modell) einen ResKey auflöst, muss diese Auflösung an die Stelle verschieben, an der das Objekt für eine Sitzung gerendert wird.
- Eine Sprachänderung baut den Steuerungsbaum des Browser-Tabs neu auf und verwirft dabei den vorübergehenden Ansichtsstatus (Scrollposition, Erweiterung, noch nicht übermittelte Formulareingaben), der sich weder in einem Kanal noch in der Personalisierung befindet. Bei einem normalen Neuladen bleibt dieser Status wie bisher erhalten.
- Beim Ein- oder Ausloggen bleibt die Seite, auf der sich die Sitzung befand, nicht mehr erhalten. Das Konto, das die Sitzung übernimmt, startet auf seiner eigenen Startseite oder auf der Standardseite der Anwendung, sofern es keine ausgewählt hat.
- Ein Popup – ein Menü, ein Dropdown-Menü der Symbolleiste, ein Flyout einer Seitenleistengruppe, die Optionsliste eines Feldes – wird aus der hervorgehobenen Fläche, dem starken Rahmen und dem Menuschatten des Themes dargestellt. Ein Design, das „layer-02“, „border-strong“ oder „shadow-menu“ anders definiert als die Standarddesigns, sorgt dafür, dass seine Popups diesen Werten folgen.