enhancement
major
minor
major
minor
major
#29618
TL-Ansichten: Eine URL blendet die Seitenleiste bei einem Eintrag mit ungespeicherten Änderungen aus, ohne nachzufragen.
Problem
Ein <nav-item> einer <sidebar> kann einen Kanal benennen, der nicht gespeicherte Änderungen an den angezeigten Inhalten meldet. Das Verlassen eines solchen Elements wird verweigert, solange es ungespeicherte Änderungen enthält: ReactSidebarControl.revealChild() fragt den „dirty“-Kanal des Elements nach seinen Handlern ab und löst eine ChannelVetoException aus, die diese enthält. Der Benutzer wird daher gefragt, ob die Änderungen verworfen werden dürfen, und der Wechsel wird erst durchgeführt, wenn er zustimmt.
Diese Frage wird nur gestellt, wenn das Element über die Benutzeroberfläche verlassen wird. Eine Sidebar ist zudem ein „RoutingParticipant“, und die durch eine URL benannte Route aktiviert ein Element über ReactSidebarControl.activateRoute(), das direkt selectItem() aufruft. Die Eingabe der URL eines anderen Abschnitts in die Adressleiste, das Folgen eines Deep-Links zu einem solchen oder das Durchlaufen des Browser-Verlaufs führt daher dazu, dass die Seitenleiste ohne Rückfrage von einem Element mit einem ungespeicherten Formular wegwechselt und die Eingabe verloren geht.
Die <tab-bar> weist denselben Mangel auf: ReactTabBarControl.activateRoute() ruft selectTab() direkt auf, während nur revealChild() den „dirty“-Kanal des Tabs abfragt.
Eine dritte Lücke führt dazu, dass die Abfrage der Seitenleiste selbst bei einem Klick fehlschlägt: Ein Formular innerhalb einer <tab-bar> meldet seine ungespeicherten Änderungen ausschließlich an den „dirty“-Kanal des Tabs, der den Kanal des Seitenleistenelements für alle Inhalte innerhalb des Tabs ersetzt. Der Kanal des Elements bleibt leer, sodass eine Seite, deren Formulare in Registerkarten liegen (jede Seite von tl-demo-react), in beiden Fällen stillschweigend ignoriert wird.
Ein vierter Fehler liegt in der Reaktion des Clients auf eine abgelehnte URL: Die Adressleiste wird mit `history.replaceState` wiederhergestellt, wodurch der Verlaufseintrag überschrieben wird, zu dem der Browser (über die Zurück- oder Vorwärts-Schaltfläche) gewechselt war – nicht derjenige, zu dem die Seite gehört. Dieser Eintrag geht verloren: Beim nächsten Drücken derselben Schaltfläche landet man auf einem Eintrag mit der aktuellen Adresse, der keine Wirkung zeigt, und beim darauffolgenden Drücken wird ein Ziel angefordert, das zwei Schritte entfernt ist.
Erwartet
Das Verlassen eines Elements wird unabhängig von der Ursache auf dieselbe Weise abgelehnt: Eine URL, die ein anderes Element aktiviert, fragt ebenso wie ein Klick auf die Seitenleiste nach ungespeicherten Änderungen und führt den Wechsel erst durch, wenn die Frage beantwortet wurde. Ungespeicherte Änderungen innerhalb eines Tabs gelten für das Seitenleistenelement, das diesen Tab anzeigt. Ein abgelehnter Druck auf „Zurück“ oder „Weiter“ belässt den Verlauf unverändert; nach „Verwerfen“ oder „Speichern“ wird der Druck als derselbe Vorgang ausgeführt, sodass die zuvor verlassene Seite über die entgegengesetzte Schaltfläche weiterhin erreichbar bleibt.
Technischer Hinweis
Entdeckt bei der Analyse von #29602 (das eine andere Ursache hat und dies nicht betrifft). Die beiden Einträge in den Element-Wechsler sind ReactSidebarControl.activateRoute(RouteMatch) und ReactSidebarControl.revealChild(String); nur letzterer fragt NavigationItem.getDirtyChannel() ab, bevor selectItem(String) aufgerufen wird. Beachten Sie, dass ein während der Übernahme einer URL ausgelöster Einwand die Übernahme beenden muss (RouteManager.cancelAdoption()), so wie es bereits bei einem „Dirty-Form“-Einwand der Fall ist, der eine URL ablehnt.
Lösung
- ReactSidebarControl.activateRoute() und ReactTabBarControl.activateRoute() laufen über revealChild(): Eine URL, die ein Element mit ungesicherten Änderungen verlässt, wird mit derselben ChannelVetoException abgelehnt wie ein Klick. Das Veto wird von RouteManager.navigateToRoute() ausgelöst. Nur das Verlassen löst eine Abfrage aus: Eine URL oder ein Klick, die das bereits angezeigte Element benennen (ein tieferes Segment, ein Abfrageparameter, ein Schritt zwischen zwei Adressen derselben Seite), lösen keine Abfrage aus.
- Der `navigateToRoute`-Handler des ReactServlet bricht bei einer ` ChannelVetoException` die Übernahme ab (`cancelAdoption()`) und beantwortet den Befehl selbst mit „refused“ sowie der Adresse der verbleibenden Seite (`currentUrl`); das SSE-Ereignis `RouteVetoEvent` entfällt. Die Antwort gehört eindeutig zu dem History-Schritt, den der Client gemeldet hat – ein SSE-Ereignis würde erst beim Schließen der Interaktion, also nach der Antwort, gesendet werden und ließe sich nicht zuordnen. Anschließend öffnet der Handler den Dialog für ungespeicherte Änderungen (DirtyConfirmDialogControl). Nach dem Speichern oder Verwerfen erhält der Client ein „RouteResumeEvent“ mit der URL und führt den abgelehnten History-Schritt selbst erneut aus; ein weiteres Veto tiefer in der URL wird als gewöhnliche Ablehnung zurückgemeldet und erneut abgefragt. Beim Abbrechen bleiben Anzeige und Adresszeile so, wie das Veto sie hinterlassen hat.
- Client (route-sync.ts): Jeder History-Eintrag, den die Anwendung schreibt, enthält in ` history.state ` seine Position und die Kennung des Seitenaufrufs (tlNav). Bei einer Ablehnung kehrt der Client mit history.go() um die Differenz zum Eintrag der angezeigten Seite zurück, ohne einen Eintrag zu überschreiben; der abgewiesene Schritt wird gespeichert und beim „RouteResumeEvent“ in der Richtung des Tastendrucks wiederholt, sodass der Browser auf dem Ziel des Tastendrucks landet und die verlassene Seite über die Gegentaste weiterhin erreichbar bleibt. Ein Eintrag eines früheren Seitenaufrufs (ohne verwertbare Position) wird wie bisher per replaceState korrigiert und beim Fortsetzen als neuer Eintrag angesteuert.
- Verschachtelte Bereiche: Ein „DirtyChannel“ kann den Kanal des umschließenden Bereichs kennen („DirtyChannel(parent)“) und meldet jeden Zustand dorthin weiter. <tab-bar> und <sidebar> legen ihre Kanäle mit dem Kanal des umschließenden Kontexts an, sodass ein Formular in einem Tab beim Verlassen des Tabs und beim Verlassen des Sidebar-Elements gezählt wird.
- Andere Ausnahmen bei der URL-Übernahme werden ebenfalls mit „refused“ beantwortet (ohne Dialog); das AgentServlet meldet ein Veto weiterhin als Fehlschlag.