enhancement
major
minor
major
minor
major
#29534
TL Views „Tile-Stack“: Frames erhalten keine feste Höhe, und ein Frame, der wieder freigelegt wird, wird von Grund auf neu aufgebaut.
Problem
Zwei Fehler von <tile-stack> (com.top_logic.layout.view.tiles), die in einer Anwendung beobachtet wurden, deren Hauptbereiche aus Drilldown-Stacks bestehen (eine Ticketliste, die eine Ticketseite anzeigt, eine Projektliste, die eine Projektseite mit Registerkarten anzeigt).
1. Ein Rahmen hat keine festgelegte Höhe
Das Client-Steuerelement (TLTileStack.tsx) rendert <div class="tlTileStack" style="width:100%; height:100%">, doch die Höhe wird nie festgelegt: Die Füllkette des Layout-CSS ist eine :has() -Liste – .tlStack:has(> .tlPanel--fill), .tlStack:has(> .tlSplitPanel) { flex: 1; min-height: 0 } – und .tlTileStack ist darin nicht enthalten, sodass sich das umschließende <stack> -Element (der übliche Host eines <tile-stack> neben seinem <slot-content> -Breadcrumb) an den Inhalt anpasst, ebenso wie alles innerhalb des Rahmens. Gemessen: Ein <panel fill="true"> mit einer Tabelle innerhalb eines Frames ist in einem 1000-px-Viewport 199 px hoch; eine Projektseite mit Registerkarten 286 px. Tabellen in Frames füllen daher niemals den Viewport aus und werden auch nicht virtualisiert, und die Seite scrollt als Ganzes statt nur der Tabellenkörper.
Eine :has() -Liste, die die zulässigen untergeordneten Typen aufzählt, ist ohnehin der falsche Mechanismus: Jedes neue Container-Element muss hinzugefügt werden, und ein Container, der in einem Container verschachtelt ist, den er nicht benennt (hier: „tile-stack“ innerhalb von „stack“), unterbricht die Kette stillschweigend.
2. Ein nicht abgedeckter Frame wird neu aufgebaut
ReactTileStackControl rendert nur den obersten Frame: Bei jedem Pfadwechsel baut es die Ansicht des obersten Frames neu auf und ruft cleanupTree() für das vorherige untergeordnete Element auf. Das Zurückblättern zu einem Frame, der auf dem Stack verblieben ist (Breadcrumb-Klick), instanziiert diesen Frame daher von Grund auf neu: Seine Tab-Leiste kehrt zur ersten Registerkarte zurück, Tabellenauswahlen und Scrollpositionen gehen verloren, ein Formular im Bearbeitungsmodus wird verworfen. Der `TileFrame` behält lediglich die Ansichtreferenz, die Beschriftung und die erfassten Parameterwerte bei, sodass nichts vom interaktiven Zustand des Frames nach dem Überdecken erhalten bleibt.
3. Ein abgelegter Frame wurde innerhalb der Benachrichtigung entsorgt, die ihn abgelegt hat
Bei der Behebung von Punkt 2 festgestellt: Der Pfad-Listener rief „cleanupTree()“ für den ersetzten Frame synchron auf. Ein Kanal benachrichtigt seine Listener mit einem Snapshot, sodass ein Steuerelement des entsorgten Teilbaums, das auf denselben Pfadkanal abhört – ein verschachtelter Breadcrumb, ein an den Pfad gebundener Kanal –, abgebaut wird, während die Benachrichtigung noch an ihn übermittelt wird. Genau für diesen Fall existiert `ChannelNotificationScope.afterNotification `, das jedoch nicht verwendet wurde.
Lösung
- Ein Füllvertrag, der sich durch Container hindurch ausbreitet und die :has() -Liste ersetzt (react-src/bridge/fill.ts): Ein Steuerelement, das füllt, trägt die einzelne Klasse tlFill (flex: 1; min-height: 0), und ein Container, der ein füllendes Kind beherbergt, füllt seinerseits weiter, bis zum ersten Element, das ohnehin begrenzt ist – dem Mount-Punkt „viewport-high“, einem „tab-content“-Bereich oder dem Körper eines scrollbaren Panels. Die Kette ist eine Eigenschaft des Pfads durch den Steuerelementbaum, daher wird dort entschieden: useFill(fills) meldet eine feste Entscheidung (<panel fill="true">), useFillHost() sorgt dafür, dass ein Container seinen untergeordneten Elementen folgt (Stack, Tile Stack, Inset, Deck Pane) oder immer ausfüllt (Split Panel, Tab-Leiste, App-Shell), und <FillBarrier> beendet die Kette an einem Bereich, der von sich aus begrenzt ist (ein Panel-Körper, ein Tab-Inhaltsbereich) oder außerhalb der Seite angeordnet ist (ein Dialog, ein Fenster, ein Drawer). Ein Container, der nichts deklariert, bleibt undurchsichtig, sodass keine Anforderung an ihm vorbeiläuft.
- Abgedeckte Frames werden beibehalten und nicht entsorgt. Der Stack hält einen Frame pro Position – die Ausgangsansicht, dann die Frames des Pfades – und zeigt den am Ende des Pfades befindlichen an; die von ihm überdeckten Frames behalten ihren Steuerungsbaum und ihre Layout-Box (die in der Größe des Stacks aus dem Fluss entfernt und unsichtbar sind), sodass die Rückkehr zu einem Frame diesen so anzeigt, wie der Benutzer ihn verlassen hat: ausgewählte Registerkarte, ausgewählte Tabellenzeile, gerade bearbeitete Werte und Scroll-Offsets eingeschlossen. Bei einer Pfadänderung werden die Frames des längsten gemeinsamen Präfixes beibehalten und die nicht mehr benötigten Frames verworfen, sodass ein aus einer URL rekonstruierter Pfad (#29530) die darin genannten Frames beibehält (TileFrame vergleicht nach Ansicht, Bezeichnung und Parametern). Das Ausblenden erfolgt über einen Wrapper, den der Stapel selbst rendert, da der Inhalt eines Frames sein eigenes Root-Element rendert und ein von außen festgelegter Stil bei der nächsten Darstellung überschrieben wird. Frames werden für skriptgesteuerte Tests als frame[<position>] adressiert, so wie ein Deck-Pane seine Pane-Elemente adressiert.
- Ein abgelegter Frame wird entsorgt, nachdem die Benachrichtigung abgearbeitet wurde (ChannelNotificationScope.afterNotification).
- Regressionsabdeckung in com.top_logic.demo.react (Tiles-Demo): Der Übersichts-Frame ist ein <panel fill="true">, sodass seine Tabelle den Ansichtsbereich ausfüllt und virtualisiert; der Detail-Frame verfügt über zwei Registerkarten, wobei die zweite eine weitere Detail-Frame einblendet, sodass der Zustand, den ein abgedeckter Frame beibehält, beobachtbar ist – die ausgewählte Registerkarte, die darin ausgewählte Zeile und die gerade bearbeiteten Werte sind nach der Rückkehr weiterhin vorhanden.
- Dokumentation zu beiden unter docs/faq/react-view-layer.md.