enhancement
major
minor
major
minor
major
#29545
TL-Ansichtstabelle: Drag & Drop von Zeilen zwischen Tabellen und auf Zeilen
Problem
Das Verschieben eines Objekts von einem Ort an einen anderen erfolgt in der Ansichtsebene (com.top_logic.layout.view) über eine Abfolge von Klicks: Zeile auswählen, Dialogfeld oder Menü öffnen, Ziel auswählen. Die direkte Geste, das Ziehen der Zeile an die gewünschte Stelle, gab es nicht. Clientseitiges Drag-and-Drop wurde in com.top_logic.layout.react nur für drei Zwecke implementiert: Datei-Upload, Neuanordnung von Spalten und die Spaltenauswahl sowie Dashboard-Kacheln. Zeilen von `TableViewControl` waren nicht verschiebbar, und eine Tabelle akzeptierte kein Ablegen.
Beispiele aus einem auf der Ansichtsebene aufgebauten Issue-Trackers: ein Board, dessen Spalten Tabellen mit den Tickets einer Statuskategorie sind, wobei das Verschieben eines Tickets in eine andere Spalte dessen Status ändert; das Einplanen eines Tickets in einen Meilenstein durch Ablegen auf der Zeile des Meilensteins; das Hinzufügen einer Beschriftung durch Ablegen des Tickets auf der Beschriftung. Bei allen handelt es sich um „Objekte von einer Tabelle auf eine Tabelle oder eine Zeile davon verschieben und anschließend eine Aktion ausführen“, daher gibt es nur einen Mechanismus, und dieser ist kein Board-Element.
Lösung
Drag-and-Drop von Zeilen als Deklaration unter <table>, wobei die Aktion eine gewöhnliche Aktionskette ist:
{{{#!xml <-- eine Spur: akzeptiert Tickets, die an einer beliebigen Stelle auf der Tabelle abgelegt werden --> <table rows="…" selection="ticket" types="demo.tickets:Ticket">
<drag/>
<drop accept="demo.tickets:Ticket">
<with-transaction>
<execute-script function="tickets -> $tickets.foreach(t -> $t.set(demo.tickets:Ticket#status, demo.tickets:TicketStatus#closed))"/>
</with-transaction>
</drop>
</table>
<-- persons: nimmt Tickets entgegen, die auf die Zeile einer Person gezogen werden --> <table rows="…" selection="person">
<drop accept="demo.tickets:Ticket" target="row" target-channel="dropTarget">
<with-transaction>
<execute-script function="tickets -> …">
<inputs><input channel="dropTarget"/></inputs>
</execute-script>
</with-transaction>
</drop>
</table> }}}
- Ziehseite. <drag type="…"/> macht die Zeilen ziehbar; das „type“-Tag ist standardmäßig auf den in der Tabelle deklarierten Zeilentyp gesetzt, und eine Tabelle, die weder das eine noch das andere deklariert, stellt einen Konfigurationsfehler dar. Das Ziehen einer ausgewählten Zeile zieht die gesamte Auswahl, das Ziehen einer nicht ausgewählten Zeile zieht nur diese Zeile. Der Client überträgt die Quellsteuerungs-ID, die Zeilenschlüssel und das Typ-Tag; die Objekte werden auf dem Server durch die Quellsteuerung (DragSourceControl) aufgelöst, sodass nur Schlüssel übertragen werden und ein Drag kein Objekt benennen kann, das die Sitzung nicht anzeigt.
- Ablegeseite. <drop accept="types"> deklariert die akzeptierten Typen und das Ziel: Tabelle (Standard; eine leere Spur ist ein gültiges Ziel) oder Zeile. Die an den Client gesendeten akzeptierten Tags werden auf dem Server zu den akzeptierten Typen und all ihren Spezialisierungen erweitert. Die Aktionen werden als ViewActionChain mit der Liste der abgelegten Objekte als Eingabe ausgeführt, sodass <with-transaction>, <execute-script>, <open-dialog>, <show-object> und die Verzweigungen von #29543 alle Anwendung finden. Bei einem Zeilenziel wird das Zeilenobjekt vor der Ausführung der Kette in den Zielkanal geschrieben (null bei einem Tabellen-Drop), sodass Skripte es als weitere Eingabe lesen. Mehrere <drop> -Deklarationen für eine Tabelle werden der Reihe nach abgeglichen, wobei Zeilen-Drops vor Tabellen-Drops erfolgen (TableDropBinding).
- Akzeptanz. HTML5-Dragover benötigt eine synchrone Antwort, daher entscheidet der Client anhand des Typ-Tags in der Nutzlast (das im Namen des dataTransfer-Typs enthalten ist, da Dragover die Daten möglicherweise nicht lesen kann) und der „dropAccepts “-Liste im Kontrollstatus über die grobe Frage und hebt die Tabelle oder die Zeile unter dem Zeiger hervor (vor, auf und nach der Zeile in Dritteln). Die detaillierte Entscheidung wird auf dem Server getroffen, wenn der Drop eintrifft: Die Kette wird ausgeführt oder lehnt mit einer Meldung ab (ein <confirm> oder <throw-error> in der Kette oder ein Veto gegen die Transaktion).
- Steuerungsnahtstelle. „TableViewControl“ implementiert „DragSourceControl“ (dragType, dragObjects(keys), dragSelection()) und nimmt ein „DropTarget“ (acceptedTypes, dropOnRows, onDrop(DropEvent)) entgegen; Der Drop-Befehl enthält die Quell-ID, Schlüssel, ein Auswahlflag, den Zielschlüssel und die Position (DropPosition), sodass ReactTreeControl und die Kompositionstabelle das Protokoll wiederverwenden können. Ein Drop wird für skriptgesteuerte Tests als dropObjects aufgezeichnet, wobei die gezogenen Objekte und die Zielzeile mit ihren Modellnamen benannt werden.
- Eine bearbeitbare Tabelle (row-edit), die <drag> oder <drop> deklariert, wird als Konfigurationsfehler gemeldet; ihr Steuerelement ist kein TableViewControl.
Dokumentation und Demo
docs/faq/react-view-layer.md, Abschnitt „Drag & Drop von Tabellenzeilen“. com.top_logic.demo.react, Ansicht „Objektliste“: zwei Spalten „Offen“ und „Geschlossen“ über demo.tickets:Ticket; das Ziehen eines Tickets zwischen diesen Spalten schreibt dessen Status; eine dritte Tabelle mit Personen akzeptiert ein Ticket, das auf die Zeile einer Person abgelegt wird, und fügt einen Kommentar hinzu, der von dieser Person verfasst wurde. Tests: TestTableViewDragDrop (tl-layout-react), TestTableDropBinding und TestTableElement (tl-layout-view).