TopLogic - the automated application engine
  • Releases
  • Dokumentation
  • Github
  • Discord
  1. Home
  2. Releases
  3. TL_8.0.0-alpha9
  4. #29525

8.0.0-alpha9
TopLogic Release

2026-10-01

enhancement

major
#27490
Historie begrenzen/abschneiden/aufräumen
#29004
Die Verwendung eines Virenscanners für Uploads zulassen
#29006
Eindeutigkeitsbeschränkung
#29421
Fügen Sie ein React-Kalender-Steuerelement und ein deklaratives UIElement „ <calendar> “ hinzu.
#29429
Vervollständigen Sie den View-Designer, damit damit eine Ansicht von Anfang bis Ende erstellt werden kann.
#29462
React: Generisches Formularelement zum Bearbeiten von Konfigurationen
#29487
React-Ansicht: „ <form> “ gibt weder die Spaltenanzahl noch die Position der Beschriftung preis, und es gibt kein „ <group> “-Element.
#29499
Hinweis auf den Wartungsmodus in der React-Oberfläche
#29507
Hinweis auf den bevorstehenden Session-Timeout in der React-Oberfläche
#29523
<sidebar> zeigt zwei der fünf Arten von Sidebar-Elementen an, die ReactSidebarControl rendert, und keines der Badges
#29525
Das Benutzermenü der App-Leiste in der Kernansichtsebene anzeigen
#29528
Das UI-Design soll sich an die Systemeinstellung für „Dunkel“ bzw. „Hell“ anpassen
#29529
Stellvertreter als explizite Sicherheitsaktion im Einstellungsdialog der TL Views benennen (mit Passwortbestätigung, auch für die Passwortänderung)
#29530
URL-Routing in TL Views: Modellobjekte in Routenparametern, Drilldown-Pfad in der URL, Abfragebindungen
#29531
Filterleiste für Tabellen: Presets, Freitextsuche über die sichtbaren Spalten und benutzereigene gespeicherte Filter
#29532
Objektnavigation in TL Views: Anzeigeziele, ein „reveal“-Protokoll für Container und eine „show-object“-Aktion
#29540
Feedback zur Benutzerfreundlichkeit des Benutzermenüs und des Dialogfelds „Persönliche Einstellungen“
#29542
TL Views: Kanalgebundene Werteingaben für jeden Primitiv- und Referenztyp mit einem „Submit“-Hook
#29543
TL-Ansichten: Bedingte Verzweigungen in einer Aktionskette mit generischen Befehlen
#29544
TL-Ansichtstabelle: Zeilenaktivierung per Doppelklick oder Enter sowie eine Gruppierungsoberfläche über dem bestehenden Tabellenmodell
#29545
TL-Ansichtstabelle: Drag &amp; Drop von Zeilen zwischen Tabellen und auf Zeilen
#29546
TL-Ansichten: Farben für Aufzählungsliterale und Klassifikatorobjekte, die als „Pills“ dargestellt werden, sowie ein Fortschrittsbalken
#29547
Generierte React-Bundles nicht mehr einchecken
#29548
React-View-Benutzeroberfläche: Die Attribute „URL“, „E-Mail“ und „Telefon“ werden als Eingabefelder bearbeitet und als Links angezeigt.
#29551
TL-Ansichten: Es dürfen nur registrierte Einstiegspunkte über eine URL auf oberster Ebene geladen werden
#29557
React-View-Befehle: Der „ExecutableState“-Wert eines deaktivierten Befehls wird niemals an den Client übermittelt, und es gibt neben „visible-if“ keine „disabled-if“-Regel.
#29567
TL Views: Mehrfachauswahl für Tabellen und Bäume (selection-mode="multi")
#29575
TL Views: UI-Inspektor – Zustand eines Elements der React-Oberfläche einsehen (z. B. durch Zugriffsrechte ausgeblendete Tabellenzeilen) und als Skript-Zusicherung aufzeichnen
#29596
TL Views: Gestaltungsoptionen für app-spezifische Oberflächen (css-class, Text-Varianten, Layout-Optionen, Anzeigevarianten für Eingaben, Theme-Tokens)
#29597
TL Views: object-list als generischer Repeater (Elemente ohne Container, Raster-Layout, Index für gestaffelte Animation)
#29598
TL Views: image mit URL-/Ressourcen-Quelle, Seitenverhältnis, Füllmodus und überlagerten Inhalten; avatar mit Foto
#29599
TL Views: Wizard-/Stepper-Element für mehrstufige Dialogflüsse (statische und dynamische Schritte, Fortschritt, Übergänge, Auto-Weiter)
#29600
TL Views: Anzeige lang laufender Server-Aufträge (Phasen, Fortschritt, unbestimmter Fortschritt, verstrichene Zeit)
#29601
TL Views: Anzeige von HTML-Inhalten und HTML-Dokumenten (Agenten-Antworten, Exposés) mit Vorschau und Druck/PDF
#29603
Physisches Löschen gelöschter Objekte aus versionierten Tabellen (Purge): Abschlussmenge über Pflichtreferenzen und Inhalte, optionale Verweise werden geleert
#29605
TL-Ansichten-Tabellenfilterleiste: eine anfänglich aktive Voreinstellung sowie die aktive Voreinstellung und der Suchbegriff als Kanäle für Abfrageverknüpfungen
#29607
TL-Ansichten: Ein Anzeigeziel zeigt eine Registerkarte innerhalb eines verschobenen Rahmens an (ein „ <show> “ befindet sich innerhalb der zuvor angezeigten Ansicht).
#29608
TL Views: value-input mit Platzhalter, zugänglicher Name bei verborgenem Label, bedingte Anzeige von Elementen mit visible-if
#29615
TL-Ansichten: Ein seitenübergreifendes „ <form> “ ist nicht am Füllvertrag beteiligt, sodass ein darin enthaltenes geteiltes oder ausfüllendes Panel entsprechend seinem Inhalt dimensioniert wird.
#29617
Designsystem: Tokens und Basisklassen als eigenes Paket (Welle 0)
#29625
TL-Ansichten: Ein Seitenlayout mit gewichteten Spalten (Hauptbereich 2/3, Seitenbereich 1/3), das bei einem schmalen Viewport auf eine Spalte umgebrochen wird; der geteilte Bereich behält seine Trennlinien bei und schneidet den Seitenbereich bei 400 px ab.
#29629
TL-Ansichten: Die Aktionen `<show-view>` und `<show-views>` zeigen eine nach Namen angegebene eingebundene Ansicht an und schreiben deren Kanäle aus einer Befehlskette ohne Modellobjekt
#29630
TL Views: Ein in Blöcke unterteilter, transaktionsbasierter Job-Körper für „ <start-job> “ – skriptgesteuerte Initialisierung / Elemente / Schritte / Abschluss, eine Transaktion pro Block, Wiederholungsversuche und Überspringen auf Elementebene, Phasen und Fortschritt, die sich aus den Schritten ableiten
#29637
Modellbasierte Berechtigungsdefinition: Zugriffselternobjekt (Delegation der Zugriffsentscheidung an Container oder Referenz, Standard für Kompositionsteile, Entscheidungs-Cache je Interaktion), Rollenelternobjekt statt Security-Parent, Vollständigkeitsprüfung und Assistent
#29640
TL Views: Gruppen einer gruppierten Tabelle werden nach dem Komparator der Gruppierungsspalte sortiert, nicht in zufälliger Reihenfolge
#29641
TL Views: Der React-TL-Script-Editor zeigt Hilfetexte zu Funktionen und Modellelementen an (Kontexthilfe zur Vervollständigung, Hover-Tooltips) und springt beim Tippen nicht mehr an den Textanfang
#29643
TL Views: Anpassung der React-Oberfläche an das Corporate Design eines Kunden mit eigener React-Komponentenbibliothek (Leitfaden und fehlende Erweiterungspunkte)
#29671
TL Views: Drag & Drop in Tabellen nach Regeln einschränken, mit Rückmeldung pro Ziel während des Ziehens
#29681
TL-Script modifiedRevision() berücksichtigt Referenz- und Übersetzungsänderungen; Attribut-Storages "touchen" das Besitzerobjekt nicht mehr
#29690
Option zum Deaktivieren des Browserstarts beim Hochfahren
#29706
Langsame Unit-Tests in tl-core und tl-element beschleunigen
minor
#28324
Dokumentation zu Layout Overlays erstellen
#29500
Es gibt keine Möglichkeit, eine Master-Detail-Ansicht als Overlay darzustellen: Die Detailansicht nimmt immer die Hälfte der Breite der Liste ein.
#29506
Eine Dashboard-Kachel kann nicht der Einstiegspunkt sein, nach dem sie aussieht: Weder <tile> noch <card> führen zu einer Aktion.
#29550
React-Kontrollen nutzen die „radius“- und „surface“-Tokens des Themes nicht einheitlich; ein „flat“-Theme erfordert CSS-Überschreibungen auf Komponentenebene
#29553
React-View- <table>: <column> hat keine Breite, jede Spalte ist standardmäßig 150 px breit, sodass eine Tabelle mit mehr als sechs Spalten über den 940 px breiten Bereich hinausragt.
#29611
TL-Ansichten: Die Aktion `<notify>` zeigt einen übersetzten Hinweis in einer generischen Befehlskette an (Snackbar oder OK-Dialog, wobei die Kette optional unterbrochen wird); `<throw-error>` wurde entfernt
#29624
SSO-Login ohne registrierten Benutzeraccount: konfigurierbare Hinweisseite (ApplicationPages.unknownAccountPage) statt Login-Maske, mit Standardseiten für die klassische und die React-Oberfläche
#29670
TL-Script: Funktionen trim, trimStart und trimEnd entfernen Leerraum am Anfang und Ende einer Zeichenkette
#29675
TL Views: Anlegen und Löschen richten sich nach den Modell-Zugriffsrechten, statt erst nach dem Ausfüllen mit „Kopieren nicht erlaubt“ abgelehnt zu werden
#29683
TL-Script: htmlText(html) kann keine Bilder enthalten, daher kann ein HTML-Text mit <img>, der auf Dateien verweist, nicht in strukturierten Text umgewandelt werden.

defect

critical
#29665
TL Views: Ein Klick in ein Rich-Text-Feld mit versteckter Beschriftung setzt die Schaltfläche „Fett“ im Editor in den Fokus, wodurch der eingegebene Text verloren geht.
#29682
TL Views: Bei einer Seite-Neuladung tritt die Ausnahme „ConcurrentModificationException“ in „ReactToolbarControl.replaceGroups“ auf, woraufhin die Seite „Interner Fehler“ angezeigt wird.
major
#25723
Fehlende Prüfung gegen Attribut-Name-Clashes bei Vererbung
#29438
Die React-View-Ebene zeigt Datumsattribute in einem fest vorgegebenen Format anstelle des kommentierten Formats an.
#29474
Keiner der beiden React-Ziehgriffe schirmt die Seite ab (oder sperrt den Cursor), während gezogen wird.
#29502
<tree> berücksichtigt keine Modelländerungen: Ein „delete“ wird nie ausgeführt, ein „create“ lässt den gesamten Baum zusammenbrechen
#29504
Zwangsabmeldung erreicht die React-Oberfläche nicht
#29509
Die Cookie-Prüfung weist den erneuten Aufruf ihrer eigenen URL ab und meldet dabei die Sitzung ab
#29512
Attribute in tl.model, die de-facto mandatory sind, auch als mandatory deklarieren
#29533
TL-Ansichten: Ausführbarkeitsregeln und abgeleitete Kanäle müssen Änderungen des Objekts auf einem Kanal berücksichtigen, nicht nur Änderungen des Kanalwerts.
#29534
TL Views „Tile-Stack“: Frames erhalten keine feste Höhe, und ein Frame, der wieder freigelegt wird, wird von Grund auf neu aufgebaut.
#29535
TL-Ansichtstabelle: Ein Auswahlkanalwert, der nicht in den Zeilen enthalten ist, darf von der Tabelle nicht gelöscht werden
#29541
Einwertiges Dropdown-Auswahlfeld zeigt zwei Schaltflächen mit der Aufschrift „Löschen“ an
#29554
React view <table>: Spalten für beliebige Zeilenobjekte – berechnete Spalten, eingebettete Spalten referenzierter Objekte, dynamische Spalten; transiente Zeilen
#29556
react-api/tooltip läuft ohne TLSubSessionContext: Ein Zell-Tooltip über einem abgeleiteten Attribut, das mit label() verwendet wird, liefert den HTTP-Status 500 (NullPointerException in Label.eval)
#29560
React view <upload-command>: Fehler beim Upload (Ausnahme in der Aktionskette, überschrittenes Größenlimit) erreichen den Benutzer nicht; Upload-Größenlimit konfigurierbar
#29562
Die in der Datei „security.xml“ für den Bereich „SecurityScopeService“ erteilten Berechtigungen gehen beim Start, bei dem der Bereich eingeführt wird, verloren: Der „AccessConfigurationSetupService“ importiert die Datei, bevor der Bereich existiert, und speichert den Datei-Hash trotzdem.
#29564
SecurityConfigurationService: Eine Anwendung kann einer Berechtigung eines Framework-Typs keine Rolle hinzufügen – eine „ <class> “-Berechtigung ist nach Operation indiziert und ersetzt den früheren Eintrag, wodurch die Rollen des Frameworks stillschweigend widerrufen werden.
#29568
TL Views: Eine ohne Anmeldung aufgerufene Route geht beim Login verloren
#29573
„TestReactStylesheetTokens“ schlägt auf dem Master-Zweig fehl: Die Regeln für „pill“ und „progress“ in tlReactControls.css halten den Theme-Token-Vertrag nicht ein.
#29574
TL Views: Veto eines verschachtelten Channel-Schreibzugriffs bricht die Benachrichtigung des äußeren Channels ab (Tabelle und Detailbereich bleiben nach "Verwerfen" auf dem alten Objekt)
#29576
React-Controls-Bundle enthält eine zweite React-Instanz (createPortal-Import in TLDropdownSelect)
#29586
Die Kompilierung von „tl-layout-react“ scheitert auf dem Master-Zweig: „TestSelectValueObservation“ und „TestResourceCellObservation“ verwenden den Konstruktor „DefaultReactContext“, der durch #29552 entfernt wurde.
#29590
React view: Mehrwertige String-Werte werden in Tabellenzellen und Anzeigefeldern ohne Trennzeichen aneinandergehängt
#29602
TL-Ansichten: Eine in eine bestehende Sitzung übernommene URL behält den Inhalt des Sidebar-Elements bei, das zuvor aktiv war.
#29604
ElementSecurityUpdateManager: Der quadratische Vergleich beim Commit (AbstractSet.removeAll auf eine Liste angewendet) führt dazu, dass das Anhängen an eine große Referenz mehrere Sekunden dauert.
#29609
TL Views: Ein `<progress>` (ChannelObjectObserver) wertet seinen Ausdruck für ein gelöschtes Objekt aus und protokolliert einen FEHLER, wenn ein beobachtetes Objekt gelöscht wird.
#29610
TL-Ansichten: Eine Tabelle auf einer inaktiven Registerkarte zeigt veraltete Zellwerte an, nachdem sich die angezeigten Objekte geändert haben, bis ihre Zeilen aktualisiert werden.
#29613
TL-Ansichten: Eine Kachel vom Typ „<dashboard> “ erhält keine feste Höhe, sodass eine Tabelle in einer Kachel mit ihren Zeilen mitwächst, anstatt gescrollt zu werden.
#29618
TL-Ansichten: Eine URL blendet die Seitenleiste bei einem Eintrag mit ungespeicherten Änderungen aus, ohne nachzufragen.
#29619
TL-Ansichten: Eine Konfigurationsbeschränkung auf Warnstufe wurde entfernt, sodass der Modell-Editor nichts anzeigt
#29620
TL Views: Ein Baumknoten ist niemals ein Link zu der Stelle, an der sein Objekt angezeigt wird, obwohl die Anzeigeziele einen solchen deklarieren.
#29622
TL-Ansichten: Ein `<flow-diagram selection="ch">` schreibt seinen Kanal, folgt ihm jedoch nicht, sodass ein an anderer Stelle ausgewählter Knoten im Diagramm nicht markiert wird.
#29623
Build: Das „translate“-Ziel übersetzt festgeschriebene deutsche Meldungen nach einem Pull oder einem Wechsel des Zweigs neu, wenn das Doclet nicht im selben Build ausgeführt wurde.
#29626
TL-Ansichten: Eine Panel-Symbolleiste verfügt über keinen Überlaufmodus; bei einer Breite von 400 px erstrecken sich die sechs Befehle der Ticket-Seite über eine Breite von 908 px, wobei drei davon nicht erreichbar sind und der Panel-Titel nach außen verschoben wird.
#29627
Tabelle „TL Views“: Eine Zelle vom Typ „I18NString“ bricht den Text um und wird durch die 36-px-Zeile mitten im Glyphenabschnitt abgeschnitten, anstatt mit drei Punkten zu enden; Kopfzeilenbezeichnungen werden ohne drei Punkte abgeschnitten.
#29631
TL-Ansichten: Mit „Escape“ wird ein „ <window> “-Dialogfeld geschlossen, während ein damit gestarteter „ <start-job> “ noch ausgeführt wird; der Job läuft weiter, ohne dass es noch etwas gibt, das angezeigt oder abgebrochen werden könnte.
#29634
TL Views: Der Konfigurationseditor erstellt ein Textfeld für eine Eigenschaft, deren Format nur zur Analyse bestimmt ist. Daher schlägt die Auswahl eines abgeleiteten Attributs im Modell-Editor mit der Fehlermeldung „Es gibt keine normgerechte Möglichkeit, eine Locator-Konfiguration zu serialisieren“ fehl.
#29635
TL-Ansichten: Ein „ <tree> “ stellt jeden Knoten als Link dar, sodass ein Klick auf die Beschriftung zu einer anderen Seite führt, anstatt nur den Knoten auszuwählen.
#29639
TL-Script objectResolve(id, typeOrTable): Auflösung über einen Typ einschließlich seiner Untertypen oder über einen Tabellennamen; objectTable liefert die Tabelle eines Objekts, und ein Objekt, auf das der aktuelle Benutzer keinen Lesezugriff hat, wird nicht aufgelöst
#29644
Inkrementelle Security unvollständig bei Verwendung von scripted-steps
#29645
TL-Script: @SideEffectFree an Funktionen aus TLScriptFunctions wird ignoriert, da der Annotation die Laufzeit-Retention fehlt
#29648
TL Views: Die über ClientResources ausgelieferten Skripte und Stylesheets tragen keine Version in der URL, der Browser verwendet nach einer Aktualisierung veraltete Client-Dateien
#29649
TL Views: Der Endstatus eines Jobs wird durch einen veralteten „Running“-Snapshot überschrieben, sodass unter „ <job-status> “ ein abgeschlossener Job als „Running“ angezeigt wird.
#29666
TL-Ansichten: Das Verlassen eines Frames über „Breadcrumb“, „Zurück“, „navigate-pop“, „show-object“ oder „Abmelden“ löscht die nicht gespeicherten Änderungen eines Formulars, ohne den Benutzer zu fragen.
#29667
TL Views: Ein Formular im Bearbeitungsmodus zeigt weiterhin veraltete Werte an, nachdem ein Befehl eine Änderung an demselben Objekt übernommen hat
#29672
TL-Ansichten: „initial-edit-mode“, ein Objektumschalter und der Kanal „edit-mode“ wechseln ohne Rückfrage in den Bearbeitungsmodus <edit-executability>
#29674
TL-Ansichten: Nach dem Laden einer Seite werden die Befehlsbezeichnungen in der App-Leiste in der Sprache des Browsers statt in der Sprache des Benutzers angezeigt („Aufzeichnen“ in einer deutschen Sitzung).
#29677
TL-Ansicht: Eine Karte in einem Spaltenstapel in Inhaltsgröße schrumpft unter ihre Inhaltshöhe; eine Tabelle daneben nimmt mehr Höhe ein, als angegeben ist.
#29678
BoundHelper: Einstellung use-default-security-parent entfernen – ohne konfigurierte Security-Parent-Regel hat ein Objekt keinen Security-Parent
#29680
Klassische Benutzeroberfläche: Der anonymen Sitzung werden die Entwickleroptionen angeboten, und sie kann „Ressourcen neu laden“ ausführen.
#29698
CollectionUtil.removeDuplicates() verliert die Reihenfolge der Elemente
#29705
Workspace/PathInfo: web-fragment.war eines Moduls wird nicht gefunden, wenn Jar und Fragment aus verschiedenen lokalen Maven-Repositories aufgelöst werden (maven.repo.local.tail)
minor
#27889
Switch auf SNAPSHOT-Version funktioniert nicht
#28474
Hintergrundfarben der Knöpfe sind nicht konsistent
#29496
React-Tabelle: Eine Spaltengrößenänderung wird mit der Meldung „Integer value expected“ abgelehnt, und die neue Breite geht verloren, wenn der Client eine Bruchzahl als Breite übermittelt.
#29497
React-UI-Tooltips: Abgeschnittene Tabellenzellen und Spaltenüberschriften, kompakte Symbolleisten-Schaltflächen und Attributbeschreibungen erhalten Tooltips; native Titelattribute werden durch Bridge-Tooltips ersetzt
#29503
TLResourceCell liefert kein CSS aus: Symbol und Beschriftung überlappen sich überall dort, wo eine Ressourcenzelle beides anzeigt
#29505
Die Höhe der Panel-Kopfzeile ändert sich, wenn die zugehörige Symbolleiste keine Befehle enthält, sodass die Kopfzeilen von Master-Detail-Ansichten nicht bündig liegen
#29508
Weitere QueryExecutor bedürfen keiner Security
#29552
TLPhotoViewer ruft sein Bild ab, nachdem das Steuerelement entsorgt wurde, wenn es durch ein „ <switch> “ ersetzt wird (404 bei react-api/data, Warnung „Command target NOT FOUND“).
#29555
TL-Script-Labels (<constant>) werden zur Kompilierungszeit umgewandelt: Das Ergebnis wird an die Locale des kompilierenden Threads angepasst und nicht an die des lesenden Benutzers.
#29558
XMLInstanceImporter importiert ein internationalisiertes Attribut, das als „value=“…“ angegeben ist, stillschweigend als leer, selbst wenn das Attribut obligatorisch ist.
#29561
TL Views: Die Anzeige eines referenzierten Objekts passt sich nicht an eine Änderung seiner Beschriftung an (Tabellenzelle, Formularfeld)
#29563
Standardgruppe: das persistierte Gruppen-Flag "defaultGroup" wird aus der Konfiguration abgeleitet statt in der Datenbank gespeichert; Semantik der Standardgruppe dokumentiert
#29591
ResKey.decode akzeptiert in #(…)-Literalen nur doppelt gequotete Übersetzungen — #('Travel'@en) schlägt fehl, obwohl TL-Script beide Quote-Arten erlaubt
#29606
TL Views: Ein `<color token>`, das ein Token benennt, das das React-Theme nicht ausgibt, führt dazu, dass die Pill ohne Farbgebung und ohne Fehlermeldung gerendert wird.
#29628
TL-Hinweis: Mit „Persönliche Einstellungen zurücksetzen“ wird die gespeicherte Konfiguration gelöscht, die laufende Sitzung behält jedoch ihren Tabellenstatus bei und schreibt ihn zurück; die festgelegten Spaltenbreiten werden erst nach einer erneuten Anmeldung wiederhergestellt.
#29636
TL-Ansichten: Ein Klick auf einen „ <tree> “-Knoten löscht den Auswahlkanal, bevor er festgelegt wird, sodass jede davon abhängige Anzeige und jeder Befehl auf leer umschaltet und wieder zurückkehrt.
#29663
TL-Ansichten: Ein „ <form> “ wird nicht mehr eingebettet; bei einem „ <fields> “-Raster innerhalb eines Formulars wurde die Seite zweimal eingebettet
#29664
TL-Ansichten: Die Befehle „Bearbeiten“, „Speichern“, „Abbrechen“ und „Übernehmen“ des Formulars sind mit einem abschließenden Punkt gekennzeichnet („Bearbeiten.“, „Speichern.“)
#29668
TL-Ansicht: Die Symbolleiste des Rich-Text-Editors ragt über ein schmales Feld hinaus; die Schaltflächen für Tabellen sowie „Rückgängig“ und „Wiederherstellen“ werden abgeschnitten
#29669
Eine Anfrage mit einem fehlerhaften Abfrage-String („?q=50%“) wird mit einer „Interner Fehler“-Seite (HTTP 500) statt mit einem 400-Fehler beantwortet.
#29673
TL-Ansichten: Personalisierungsbefehle („Layout bearbeiten“, „Diesen Filter speichern“) werden der anonymen Sitzung angeboten
#29676
TL Views-Admin: Beim Löschen eines Kontos wird im weiterhin geöffneten Kontoformular die Meldung „Zielobjekt wurde gelöscht“ angezeigt; für den Löschvorgang ist keine Bestätigung erforderlich.
#29679
TL Views: Ein Befehl, der aufgrund seiner Ausführbarkeitsregel abgelehnt wird, wird mit dem Titel „Interner Fehler“ gemeldet.

task

minor
#29612
FAQ: Migrationsleitfaden für das Upgrade einer Anwendung von TL 7.11 auf 8.0
#29702
Mindestversion von Maven im Build auf 3.8.9 anheben
enhancement

major

#29525

Das Benutzermenü der App-Leiste in der Kernansichtsebene anzeigen

MigrationReactUI

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.
  • Get Started
  • Github
  • Discord
  • Das Unternehmen hinter TopLogic
  • Softwareentwicklung heute
  • Kontakt

© Copyright – Business Operation Systems GmbH

  • top-logic.com
  • Nutzungsbedingungen
  • Impressum
  • Rechtlicher Hinweis
  • Datenschutz
  • EN
  • Login