enhancement
major
minor
major
minor
major
#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.
Problem
Der Header <panel> der Ticket-Seite im Issue-Tracker tl-dev (ticket.view.xml) enthält sechs Symbolleistenbefehle (Zurück, Akzeptieren, Lösen, Neue Unteraufgabe, Löschen sowie die Schaltfläche „Bearbeiten“ des Formulars), die jeweils als Symbol mit Beschriftung dargestellt werden.
Gemessen bei einer Auflösung von 400×800 (Engine-Snapshot-Build 37 vom 16.09.2026): Die Symbolleiste ist innerhalb eines 400 px breiten .tlPanel__header 908 px breit (scrollWidth 932, clientWidth 400, overflow-x: visible). „Zurück“ (24..137 px) und „Übernehmen“ (145..298 px) sind sichtbar, „Abschließen“ (306..457 px) ist zur Hälfte abgeschnitten, „Neue Teilaufgabe“ (465..650 px), „Löschen“ (658..781 px) und „Bearbeiten“ (788..932 px) sind nicht erreichbar – nichts scrollt sie in den sichtbaren Bereich, und es gibt kein Überlaufmenü. Der Panel-Titel „Ticket“ wird überhaupt nicht dargestellt, da er von der Symbolleiste verdrängt wird.
Das ReactToolbarControl verfügt über Gruppenanzeigen (ToolbarGroupDisplay.INLINE, …) jedoch keine Regel für den Fall, dass die Inline-Schaltflächen nicht passen.
Das Gleiche gilt für die Fußzeile eines Dialogfensters: Die <actions> eines <window> (typischerweise „Abbrechen“) und die Schaltflächen der mit Java erstellten Dialoge (Bestätigung nicht gespeicherter Änderungen mit „Abbrechen“/„Verwerfen“/„Speichern“, Bestätigungsdialog, I18N-Editor, Tabellenspaltendialoge, Passwortabfragen) sind einfache Geschwisterelemente in einer rechtsbündigen Flex-Zeile und werden niemals zusammengeklappt. Sobald sie breiter als die Fußzeile sind, läuft die Fußzeile an ihrem linken Rand über, sodass als Erstes genau der Überlaufauslöser der daneben liegenden, zusammengeklappten Schaltflächenleiste abgeschnitten wird.
Anforderung
Eine Panel-Symbolleiste, deren Kopfzeile bei jeder Breite passt: Schaltflächen, die nicht passen, werden der Reihe nach in ein Überlaufmenü („…“) verschoben, Beschriftungen weichen dort, wo die Befehlsanzeige dies zulässt, zuvor Symbolen, und der Panel-Titel behält seinen Platz. Die <app-bar> -Aktionen der App-Leiste haben auf einem Smartphone denselben Anspruch, ebenso wie die Fußzeile eines Dialogfensters.
Lösung
Die Toolbar der TL-Views (TLToolbar, das Client-Gegenstück von ReactToolbarControl) passt sich der verfügbaren Breite an. Sie gibt ihre natürliche Breite als eigene Breite an (daran bemisst ihr Host seinen Platz), misst, was der Host ihr tatsächlich gewährt (ResizeObserver), und klappt in zwei Stufen zusammen:
- Schaltflächen mit Symbol und Beschriftung zeigen nur noch ihr Symbol an (Modifikator tlToolbar--compact; die Beschriftung bleibt als zugänglicher Name und Tooltip erhalten). Schaltflächen ohne Symbol behalten ihre Beschriftung.
- Einträge, die danach immer noch nicht passen, wandern in ein Überlaufmenü („…“, zugänglicher Name js.toolbar.overflow), in ihrer ursprünglichen Reihenfolge. Eine bereits als Menü dargestellte Gruppe (View, Export, More) wird als eigener, durch eine Trennlinie abgesetzter Abschnitt übernommen; ausgeblendete Befehle erzeugen keine leeren Menüeinträge.
Wird wieder mehr Platz verfügbar, kehren die Einträge in umgekehrter Reihenfolge zurück.
Die Richtung des Zusammenklappens ist ein Zustand der Symbolleiste (ReactToolbarControl#OVERFLOW, Enum ToolbarOverflow: NONE, TRAILING, LEADING) und wird vom ToolbarBuilder aus der Anordnung der Befehle abgeleitet:
- TOOLBAR (Panel-Kopf, Fenster-Titelzeile, Vollbild): Die Symbolleiste klappt von rechts nach links zusammen, das Überlaufmenü befindet sich am rechten Ende. Der Host räumt der Symbolleiste beim Zusammenklappen Vorrang ein (--tl-toolbar-shrink-priority) und lässt sie niemals unter die Breite des Menüauslösers (--tl-toolbar-trigger-size) fallen; der Panel-Titel wird erst gekürzt, wenn die Toolbar auf die Auslösergröße geschrumpft ist.
- BUTTON_BAR (Dialog- und Panel-Fußzeile): Die Leiste klappt von links nach rechts zusammen, das Überlaufmenü befindet sich am linken Ende. Die primäre Aktion am rechten Ende bleibt so am längsten sichtbar.
- Symbolleisten, die nicht über den ToolbarBuilder erstellt werden, behalten den Wert „NONE“.
Die Aktionen der <app-bar> werden über denselben Mechanismus dargestellt: AppBarElement baut seine Aktionen wie die anderen Befehlsbereiche über den ToolbarBuilder als ReactToolbarControl auf, das bei Änderungen des Bereichs an Ort und Stelle neu gefüllt wird (replaceGroups); ReactAppBarControl ist kein ToolbarControl mehr. Die Media-Query, die Beschriftungen bei einer Breite unter 768 px ausblendete, entfällt zugunsten der Anpassung an die tatsächlich verfügbare Breite.
Fußzeile eines Dialogfensters. Die Fußzeile eines ReactWindowControl ist eine einzige zusammenklappbare Schaltflächenleiste (ToolbarOverflow.LEADING), die zum Fenster selbst gehört. Die <actions> des <window> (bzw. die über setActions übergebenen Schaltflächen der Java-Dialoge) bilden darin die vorderste Gruppe, dahinter folgen die BUTTON_BAR-Befehle des Scopes. Die Schaltflächen lassen sich somit als „Abbrechen, …, primäre Aktion“ lesen – die Reihenfolge, die Carbon, Material und die Apple-Richtlinien vorgeben (die primäre Aktion steht rechts) – und die zuerst ausgeblendete Schaltfläche ist „Abbrechen“, das über die Escape-Taste und das X in der Titelleiste weiterhin erreichbar bleibt. setActions und setButtonBar behalten ihre Signatur; ein Neuaufbau des Scopes ersetzt nur die Befehlsgruppen, die Aktionsgruppe bleibt erhalten. Der Client rendert in der Fußzeile nur noch dieses eine Toolbar-Kind; den Zustandsschlüssel „actions“ des Fensters gibt es nicht mehr.
Dabei behoben: Der Wrapper, in dem ein <form> seine eigenen <commands> dem umgebenden Scope anbietet (FormElement.FormScopedCommandModel), delegierte nur einen Teil der CommandModel-Zugriffe; Tastenkürzel (key="ENTER"), Tooltip, Clique, Anzeigemodus und CSS-Klassen eines Formularbefehls gingen verloren. Er delegiert nun vollständig (abgesichert durch TestFormScopedCommands).
Demo: Im Dialog „Neues Ticket“ von tl-demo-react gibt es einen zweiten Fußzeilen-Befehl („Geschlossen anlegen“), damit das Überlaufverhalten einer Schaltflächenleiste sichtbar ist; „Anlegen“ trägt key="ENTER".