enhancement
major
minor
major
minor
major
#29602
TL-Ansichten: Eine in eine bestehende Sitzung übernommene URL behält den Inhalt des Sidebar-Elements bei, das zuvor aktiv war.
Problem
Eine auf der Ansichtsebene (com.top_logic.layout.view) erstellte Anwendung verfügt über eine <sidebar> mit zwei <nav-item>-Elementen, von denen jedes ein `<tile-stack>` enthält, dessen Ansichten ihre Breadcrumb-Navigation über <slot-content to="appbar-content"> in die App-Leiste projizieren (das Layout des Issue-Trackers tl-dev: Bereiche „Tickets“ und „Projekte“).
Schritte (Engine-Snapshot vom 16.09.2026, Build 37 von tl-layout-view):
- Anmelden, den Bereich „Tickets“ öffnen, eine Ticket-Seite auf den Stack schieben (Breadcrumb „Tickets / TL-54“).
- Wechseln Sie über die Seitenleiste zu „Projekte“ und öffnen Sie ein Projekt (Breadcrumb „Projekte / TopLogic“). Die App-Leiste zeigt erwartungsgemäß einen Breadcrumb an.
- Geben Sie /view/tickets in die Adressleiste ein (oder laden Sie die Seite unter dieser URL neu).
Beobachtung: Die Seitenleiste blendet „Tickets“ ein und der Inhaltsbereich zeigt die Ticket-Seite an, aber die App-Leiste zeigt nun zwei Breadcrumbs an: „Tickets / TL-54 “ und „Projekte / TopLogic“. Der Slot-Inhalt des Elements „Projekte“, das nicht mehr angezeigt wird, bleibt in der App-Leiste projiziert. Das Gleiche geschieht in umgekehrter Richtung (Eingabe von /view/projects, während „Tickets“ aktiv ist: „Projekte / TopLogic“ plus „Tickets / TL-54“).
Das Wechseln zwischen den Abschnitten über die Seitenleiste selbst führt nicht zu diesem Fehler: Nach Schritt 2 enthält die App-Leiste nur noch den Breadcrumb „Projekte“, und ein Klick auf „Tickets“ in der Seitenleiste hinterlässt nur den Breadcrumb „Tickets“.
Nicht app-spezifisch: Die App deklariert nichts über <nav-item>, <tile-stack> und <slot-content> hinaus; die Projektion eines Slots in die App-Leiste erfolgt über den Slot-Mechanismus der Engine.
Erwartet
Das Aufrufen einer URL führt zu derselben Darstellung wie das Erreichen dieses Zustands über die Benutzeroberfläche: Der Inhalt des vorherigen Seitenleistenelements, einschließlich aller in Slots projizierten Elemente, verschwindet aus der App-Leiste.
Ursache
Weder der Slot-Mechanismus noch der Elementwechsel in der Seitenleiste sind schuld, und der Fehler ist nicht spezifisch für die Übernahme einer URL.
Ein Slot-Beitrag ist an den Anzeigestatus des Steuerelements gebunden, das ihn deklariert: „SlotContentControl“ registriert sich bei der „SlotRegistry“, wenn es angeheftet wird, und hebt die Registrierung auf, wenn es abgelöst wird. Das Übernehmen einer URL hält diesen Vertrag ein – sobald die Seite gerendert wurde, ist genau ein Beitrag registriert. Was das Problem verursacht, ist der nachfolgende Schritt: Die frisch geladene Seite öffnet ihren Ereignisstrom, und ` SSEUpdateQueue.sendFullState()` übergibt dem Client den Zustand jedes registrierten Steuerelements, nicht nur derjenigen, die das Fenster anzeigt.
Jedes Steuerelement registriert sich beim Erstellen in der Aktualisierungswarteschlange des Fensters und wird erst beim Entsorgen entfernt. Eine Seitenleiste speichert den Inhalt eines besuchten Elements in einem Cache und entsorgt ihn nie, sodass der zurückbleibende Teilbaum des Elements weiterhin registriert ist – zwar abgetrennt, aber erreichbar. Die Serialisierung seines Zustands greift auf die darin eingebetteten Steuerelemente über, und die Serialisierung eines Steuerelements bindet es ein (ReactControl.writeAsChild() ruft attachOnRender() auf, wodurch „gerendert bedeutet angezeigt“ festgelegt wird). Durch das erneute Senden wird daher ein Teilbaum, den das Fenster nicht anzeigt, erneut angehängt, sein `SlotContentControl ` wird ein zweites Mal registriert, und die App-Leiste rendert beide Beiträge.
Zwei Konsequenzen, die über das gemeldete Symptom hinausgehen:
- Jeder geöffnete Ereignisstrom lässt die verwaisten Teilbäume, die ein Fenster enthält, wieder aufleben – ebenso eine Wiederverbindung nach einer Netzwerkunterbrechung. Eine eingegebene URL oder ein Neuladen ist der reproduzierbare Auslöser, da dadurch immer ein neuer Stream geöffnet wird.
- Alles andere, was ein wiederhergestellter Teilbaum beim Anfügen registriert, kehrt mit ihm zurück, insbesondere seine `RoutingParticipant`s: Die zusammengesetzte URL enthält dann Segmente einer Seite, die nicht angezeigt wird – die fehlerhafte Klasse, die in #29530 eine Ebene höher entfernt wurde.
Lösung
Die „Full-State“-Neusendung übermittelt den Zustand der Steuerelemente, die das Fenster anzeigt. Die Warteschlange trägt diesen Begriff bereits für die Ereignisse, die sie für ein Steuerelement verwirft, „das dieses Fenster nicht mehr anzeigt: eines, das entsorgt (und damit abgemeldet) wurde, oder eines, das von einem Container getrennt wurde“; dasselbe Prädikat entscheidet nun darüber, was die erneute Übertragung ausgibt, sodass es statt zwei nur noch eine Definition dafür gibt, was ein Fenster anzeigt. Ein Steuerelement, das nur für die Befehlsweiterleitung registriert ist, wird nicht mehr serialisiert und daher auch nicht mehr hinter dem Rücken der Anzeige angehängt.
Ein Regressionstest in com.top_logic.layout.view spielt nach, was das Servlet tut, wenn eine Seite in den Baum geladen wird, den ein Fenster bereits enthält – die verbleibende Seite wird entladen, die URL übernommen, der Baum angehängt, gerendert und die Übernahme abgeschlossen, und die geladene Seite öffnet ihren Ereignisstrom – über eine App-Shell, deren App-Leiste einen Slot enthält und deren Seitenleiste zwei Elemente bietet, die jeweils in diesen hineinragen. Er überprüft die Invariante, dass jeder registrierte Beitrag zu einem Steuerelement gehört, das der angezeigte Baum enthält, und zwar für den Klick auf die Seitenleiste, einen Deep-Link in eine neue Anzeige und eine von einer existierenden Anzeige übernommene URL, mit und ohne Drilldown in einem der beiden Elemente.