major
#29474
Keiner der beiden React-Ziehgriffe schirmt die Seite ab (oder sperrt den Cursor), während gezogen wird.
**Betrifft** 8.0.0-alpha7 · **Schweregrad** Echter Fehler beim Trennbalken für geteilte Fenster (reproduzierbar im anwendungsinternen PDF-Viewer bestätigt); kleinere Verbesserungen der Benutzererfahrung beim Tabellen-Zugriffselement
Zusammenfassung
Zwei miteinander verbundene Mängel, die gemeinsam bei der Überprüfung eines Design-Leitfadens für Drag-Handles anhand der beiden resizable-drag-Affordances von tl-layout-react festgestellt wurden:
- Keine Überlagerung durch Pointer-Events während eines Drag-Vorgangs. Weder der Drag-Handler von `.tlSplitPanel__splitter` noch der von `.tlTableView__resizeHandle` fügt eine Abschirmungsebene über den Rest der Seite ein. Wenn der Mauszeiger während des Ziehens über ein `<iframe> ` fährt, kann das eigene Dokument dieses iframes die Maussteuerung übernehmen und die Größenänderung blockieren. Konkret reproduziert mit einem `<pdf> `-Element (PdfElement/`TLPdfViewer`, ein tatsächliches `<iframe>), das neben einer Trennlinie des geteilten Fensters liegt.
- Der Spalten-Handle der Tabelle fixiert den Cursor nicht auf <body>. Die Trennlinie des geteilten Fensters tut dies korrekt (document.body.style.cursor wird bei „mousedown“ gesetzt und bei „mouseup“ zurückgesetzt), sodass ihr Cursor niemals flackert, wenn der Mauszeiger während eines schnellen Ziehvorgangs von der dünnen Trennlinie abweicht. .tlTableView__resizeHandle stützt sich ausschließlich auf den CSS -Cursor seines eigenen Elements, dessen Anwendung jedoch in dem Moment endet, in dem der Zeiger dieses Element verlässt.
Reproduktion
- (Overlay) Öffnen Sie eine Ansicht mit einer Trennlinie für geteilte Bereiche neben einem iframe (z. B. einer PDF-Vorschau) und ziehen Sie die Trennlinie so schnell, dass der Mauszeiger während des Ziehvorgangs den iframe überquert. Die Ziehfunktion wird unterbrochen, sobald der Mauszeiger den iframe betritt.
- (Cursor) Öffne eine beliebige Tabelle, beginne, eine Spaltengrenze zu ziehen, und bewege dann den Mauszeiger einige Pixel über oder unter die Kopfzeile, während du die Maustaste weiterhin gedrückt hältst. Der Cursor wechselt zum Standardpfeil zurück, obwohl der Ziehvorgang noch aktiv ist.
Auswirkungen
Die Überlappungslücke ist kein hypothetisches Problem – es handelt sich um genau den Mechanismus, auf den ein Referenzdesign-Leitfaden hinweist, und jede Anwendung mit einem Iframe neben einem Trennbalken für geteilte Fenster löst ihn aus. Die Cursor-Lücke ist reine Kosmetik, lässt sich aber ohne zusätzlichen Aufwand beheben, sobald das Overlay vorhanden ist (das Overlay-Element selbst kann den Cursor-Stil übernehmen und beide abdecken).
Vorgeschlagene Lösung
Beide Drag-Handler sollten bei „mousedown“ für die Dauer des Ziehvorgangs eine Ebene mit „position: fixed; inset: 0“ über den Rest der Seite einfügen (mit dem entsprechenden Cursor für „col-resize“/`row-resize`, der darauf oder auf <body> gesetzt ist) und diese bei „mouseup“ wieder entfernen. Die Trennlinie des geteilten Fensters beweist bereits, dass der Teil „Cursor auf <body> fixieren“ mit drei Zeilen behoben werden kann; der Tabellen-Handle benötigt dieselben drei Zeilen sowie das Overlay-Element selbst für beide.
Workaround in der Anwendung (Beratung)
Wird als einfaches clientseitiges Modul-Skript ausgeliefert – „mousedown“/`mouseup`-Listener auf Dokumentebene, die das Overlay ein- bzw. ausblenden und den Body-Cursor für beide Handle-Typen sperren bzw. entsperren. Es ist kein Serverbefehl erforderlich. Live verifiziert: Das Overlay erscheint und verschwindet bei beiden Griffarten korrekt, der Cursor des Tabellen-Griffs bleibt während des gesamten Ziehvorgangs im „col-resize“-Modus, und keine der Änderungen beeinträchtigt die eigene Größenanpassung des Frameworks.
Lösung
Der React-Client (com.top_logic.layout.react) erhält einen gemeinsamen Drag-Gesture-Helper (startPointerDrag in react-src/bridge/pointer-drag.ts, exportiert aus tl-react-bridge), den jeder Drag-Handle in der React-Benutzeroberfläche nutzt. Das Starten eines Drag-Vorgangs durch ein `pointerdown` -Ereignis
- wird der Zeiger auf dem Handle-Element erfasst (setPointerCapture), sodass der Browser die gesamte Geste an das Handle weiterleitet, unabhängig davon, was sich unter dem Zeiger befindet – ein <iframe> (PDF-Viewer, eingebettetes HTML) empfängt die Ereignisse nie und kann das Ziehen nicht blockieren; Maus, Touch und Stift funktionieren gleich,
- Sobald sich der Zeiger um 3 px vom Druckpunkt entfernt hat, wird ein das gesamte Viewport abdeckendes Schutzelement (.tlDragShield, position: fixed; inset: 0, z-index über jeder Dialog-, Menü- und Snackbar-Ebene), das den Cursor der Geste trägt (Spaltengrößenänderung, Zeilengrößenänderung, Greifen, die richtungsabhängigen Größenänderungscursor, …) und die Textauswahl unterdrückt, sodass der Cursor niemals flackert, wenn der Zeiger den schmalen Griff verlässt. Ein Druck, der sich nicht bewegt, löst kein Schutzelement aus und meldet nichts: Ein Klick oder Doppelklick auf einen Griff erreicht weiterhin den Griff (Doppelklick „An Inhalt anpassen“ an einem Spaltenrand, Doppelklick „Maximieren“ auf einem Fenstertitel), und ein Klick auf eine Trennlinie sendet die Fenstergrößen nicht mehr an den Server;
- hebt den Schutz und die Listener bei „pointerup“ auf und teilt dem Griff mit, ob es sich bei der Geste überhaupt um ein Ziehen handelte; bei „pointercancel“ / Verlust der Erfassung (z. B. wenn eine native Geste die Kontrolle übernimmt oder der Griff das Dokument verlässt) wird dem Griff stattdessen mitgeteilt, seinen Zustand vor dem Ziehen wiederherzustellen, sodass kein Ziehen ohne einen Zeiger, der es beendet, fortbesteht.
Alle „Drücken-Ziehen-Loslassen“-Gesten werden an den Helper weitergeleitet: die Trennlinie für geteilte Bereiche, der Griff zur Größenänderung von Tabellenspalten, die Trennlinie für fixierte Spalten in der Tabelle, die Fenstertitelleiste (Verschieben) und die Griffe zur Größenänderung an Fensterkanten/-ecken, die Ziehvorgänge zum Verschieben, Ändern der Größe und Erstellen von Kalenderereignissen (die an das Zeitraster gebunden sind, da ein in einen anderen Tag gezogenes Ereignis in der Spalte dieses Tages neu dargestellt wird) sowie das Sättigungsfeld und der Farbton-Schieberegler des Farbmischers. Der „document.body.style.cursor“-Hack pro Steuerelement und die Ad-hoc-Listener für „move“ und „up“ auf Dokument-/`window`-Ebene sind weg; das anwendungsseitige Workaround-Skript wird nicht mehr benötigt.
Popups schließen sich bei „pointerdown“. Die Ziehpunkte verhindern das standardmäßige „pointerdown“-Ereignis, sodass der Browser dafür kein Kompatibilitäts -„mousedown“-Ereignis auslöst; ein Popup, das sich bei einem „mousedown“ auf dem Dokument geschlossen hätte, bliebe offen, wenn ein Ziehen an einem Trennbalken oder einem Fenstertitel beginnt. Jedes Popup der React-Benutzeroberfläche (TLMenu, die Dropdown-Gruppe der Symbolleiste, das Flyout der Seitenleisten-Gruppe, TLDropdownSelect, die Symbol- und Farbauswahlfelder, das Kontextmenü der Tabellenspalten) wird daher über einen gemeinsamen Bridge-Hook geschlossen (useCloseOnOutsidePress in react-src/bridge/outside-press.ts, exportiert aus tl-react-bridge), das in der Capture-Phase auf das `pointerdown`-Ereignis des Dokuments wartet: Ein Klick erreicht das Popup unabhängig davon, wie das Element unter dem Zeiger darauf reagiert; weder `preventDefault` noch `stopPropagation` an einem Handle können ein Popup offen halten. Ein Popup legt fest, auf welchen Elementen ein Klick landen darf, ohne dass es geschlossen wird (sein eigenes Element und sein Auslöser, sofern dieser das Popup umschaltet); daher schließt ein Klick auf einen Umschalt-Auslöser das Popup weiterhin, anstatt es beim Drücken zu schließen und beim Klicken wieder zu öffnen. Die sieben privaten „mousedown“-Listener wurden entfernt.
Ein Klick auf den Auslöser eines geöffneten Popups schließt dieses. Ein Auslöser, der sein Popup beim Klicken öffnet, ohne zu wissen, ob das Popup bereits geöffnet ist – der durch Klicken ausgelöste Menübereich (TLMenuRegion, dessen Menü der Server anhand von Koordinaten platziert), das Symbolfeld (TLIconSelect) und das Farbfeld (TLColorInput) – schloss das Popup beim Drücken und öffnete es beim Klick derselben Geste wieder, sodass das Popup nie sichtbar geschlossen wurde. Dasselbe Modul verfolgt die aktuelle Geste: Ein beim Laden der Bridge installierter „Document Pointerdown “-Listener (initOutsidePress, vor dem eigenen Listener jedes Popups) setzt ein Flag zurück, das durch den Hook beim Schließen gesetzt wird, und pressClosedSurface() reagiert auf den folgenden Klick. Die drei Auslöser überspringen das Öffnen, wenn das Drücken ihres Klicks bereits ein Popup geschlossen hat. Ein Klick ohne begleitendes Drücken (Tastaturaktivierung der Farbfeld-Schaltfläche, detail === 0) löscht das Flag, sodass die Eingabetaste oder die Leertaste auf einem fokussierten Farbfeld immer zum Öffnen führt.
Die letzte fixierte Spalte lässt sich über ihren Rand in der Größe anpassen. Der Griff der fixierten Spalte (.tlTableView__frozenSplitter, 7 px) befindet sich rechts von der eingefrorenen Grenze, anstatt diese zu überspannen, und der Größenänderungsgriff der letzten eingefrorenen Überschrift (.tlTableView__resizeHandle, 5 px) endet an der Grenze innerhalb ihrer Zelle, genauso wie die Überschrift vor der ersten Spalte mit festgestecktem Ende ihren Griff innerhalb der Zelle behält. Die beiden Griffe überlappen sich nicht mehr: Die Pixel links vom Rand ändern die Spaltenbreite, die Pixel auf und rechts davon verschieben die Grenze der fixierten Spalte. Die sichtbare 1-px-Linie des Griffes bleibt auf dem Rand.
Überprüft mit Playwright in tl-demo-react: Der PDF-Demo-Trennbalken wurde mit dem Zeiger tief im PDF um 440 px verschoben <iframe> (Fenster folgt über die gesamte Strecke, Schutzsymbol bei Spaltengrößenanpassung vorhanden, nach Loslassen verschwunden, Größe beibehalten), ein Spaltenrand, der mit dem Zeiger 60 px unterhalb der Kopfzeile gezogen wurde (Breite passt sich an, Schutzsymbol vorhanden, verschwindet nach dem Loslassen), ein Druck ohne Bewegung (kein Schutzsymbol), Doppelklick zum Anpassen an einen Spaltenrand, der Trenner für fixierte Spalten, die „Erstellen durch Ziehen“-Geste des Kalenders; das Spalten-Kontextmenü und ein geöffnetes Dropdown-Menü schließen sich bei einem Druck auf die Trennlinie des geteilten Fensters (Schild während dieses Ziehens vorhanden), ein Kontextmenüpunkt wird beim Klicken weiterhin ausgeführt, ein Klick außerhalb schließt das Menü weiterhin; der Benutzermenübereich, die Symbolauswahl und die Farbauswahl öffnen sich beim ersten Klick, schließen sich beim zweiten und bleiben geschlossen, öffnen sich beim dritten erneut, und die Symbolauswahl öffnet sich bei Drücken der Eingabetaste; die letzte fixierte Spalte („Name“ in der Attribut-Tabelle) lässt sich über ihren Rand in der Größe anpassen; der Fixiergriff lässt sich weiterhin zur nächsten Spaltengrenze und zurück ziehen und beginnt am linken Rand der Tabelle, wenn nichts fixiert ist; keine Konsolenfehler.