enhancement
major
minor
major
minor
minor
#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.
Beobachtet in tl-demo-react, Demos → Tree Demo, bei der Überprüfung von #29635: Ein einzelner Klick auf einen Knoten führt dazu, dass der Server zwei Patches für die Anzeige des ausgewählten Kanals sendet – zuerst {"text":""}, dann {"text":"M3"} – und die mit der Auswahl verknüpften Befehle in der Symbolleiste werden zwischendurch deaktiviert und wieder aktiviert. Der Endzustand ist korrekt; der Hin- und Rückweg ist jedoch überflüssig und führt bei einer langsameren Verbindung oder einer ressourcenintensiveren abhängigen Ansicht zu einem sichtbaren Flackern.
Ursache
ReactTreeControl.selectOnly(node) (Einzelauswahlmodus und der Auswahlschritt einer Aktivierung) ersetzt die Auswahl in zwei Schritten:
{{{#!java _selectionModel.clear(); _selectionModel.setSelected(node, true); }}}
Jeder Schritt löst ein Auswahlereignis aus. TreeSelectionBinding.handleSelectionChanged schreibt bei jedem Ereignis in den Kanal: null für die leere Auswahl, dann das Objekt. Jeder Listener des Kanals – abgeleitete Kanäle, die daran gebundenen Anzeigen, die Ausführbarkeit der Befehle, deren Eingabe er ist – wird zweimal ausgeführt, und der Client empfängt den zwischengeschalteten leeren Zustand als Patches.
Das Gleiche gilt für einen Shift-Bereich im Mehrfachauswahlmodus: `handleSelect` ruft `setSelected` einmal pro Knoten des Bereichs auf, sodass der Kanal einmal pro Knoten beschrieben wird und eine daran gebundene Anzeige den wachsenden Bereich anzeigt.
SelectionModel.setSelection(Set) ersetzt die Auswahl in einem Schritt mit einem Ereignis; setSelected(obj, true) eines Einzelauswahlmodells ersetzt die vorherige Auswahl bereits von selbst.
Lösung
ReactTreeControl ersetzt die Auswahl in einem Schritt, sodass pro Geste ein Auswahlereignis den Kanal erreicht:
- selectOnly (einfacher Klick, Doppelklick/Enter-Aktivierung) ruft _selectionModel.setSelection(Set.of(node)) auf. Beide vom View-Layer eingebundenen Auswahlmodelle (DefaultSingleSelectionModel, DefaultMultiSelectionModel) lösen dafür genau ein Ereignis aus und keines, wenn der Knoten bereits Teil der Auswahl ist.
- Der Shift-Bereich sammelt die auswählbaren Knoten des Bereichs und wendet sie mit einem „addToSelection“- oder „removeFromSelection“-Aufruf an, je nachdem, ob der Anker zur Auswahl hinzugefügt oder aus ihr entfernt wurde.
- Die Strg -Umschaltung war bereits ein Ereignis und bleibt unverändert. TreeSelectionBinding, die Auswahlmodelle und der Client bleiben unberührt.
Die Befehls-IDs SELECT_COMMAND / ACTIVATE_COMMAND und die Status-Schlüssel NODES / NODE_ID von ReactTreeControl sind öffentliche Konstanten, wie bei den anderen React-Steuerelementen, sodass Tests die Gesten genauso senden wie der Client, ohne die Wire-Namen neu anzugeben.
Tests: TestReactTreeControlSelection (tl-layout-react) sendet die Befehle „select“ und „activate“ über ReactControl.executeCommand und überprüft, ob pro einfachem Klick, Strg-Klick, Umschalt-Auswahl (Hinzufügen und Entfernen) sowie Aktivierung jeweils ein Auswahlereignis erfolgt und ob bei einem Klick auf den bereits ausgewählten Knoten kein Ereignis auftritt. TestTreeSelectionBinding überprüft, ob bei zwei Klicks genau [A, B] in den Kanal geschrieben wird und ob eine Umschalt-Auswahl als ein einziger Wert ankommt. Verifiziert in tl-demo-react, Tree Demo: Ein MutationObserver auf der Anzeige „Ausgewählter Knoten“ zeichnet genau einen Textwert pro Geste auf, niemals einen leeren Zwischenwert.