major
#29544
TL-Ansichtstabelle: Zeilenaktivierung per Doppelklick oder Enter sowie eine Gruppierungsoberfläche über dem bestehenden Tabellenmodell
Problem
Zwei Lücken im Element <table> (TableElement, com.top_logic.layout.view) und dessen Steuerelement (TableViewControl, com.top_logic.layout.react), die beide in einem auf der Ansichtsebene basierenden Issue-Tracker festgestellt wurden.
1. Eine Zeile konnte nicht aktiviert werden
Die vom Tabellen-Control akzeptierten Befehle waren „select“, „selectByKey“, „moveSelection“, „selectAll“, „sort“, „scroll“, „expand“ sowie die Spalten- und Filterbefehle. Es gab keinen Befehl für „Diese Zeile öffnen“: Eine Liste öffnete ihre Details nur, wenn die Zeile ausgewählt und anschließend ein Befehl in der Symbolleiste betätigt wurde – zwei Klicks und eine Mausbewegung für die häufigste Interaktion in einer listengesteuerten Anwendung. Doppelklick und die Eingabetaste hatten keine Wirkung. Die automatischen Verknüpfungen aus #29532 beziehen sich auf in Zellen angezeigte Referenzwerte, nicht auf die Zeile selbst.
2. Die Gruppierung war im Modell vorhanden, wurde jedoch weder im Steuerelement noch in der Konfiguration umgesetzt
Das Tabellenmodell gruppiert bereits: TableView.group(GroupSpec), RowSource.withGrouping, einspaltige Gruppierung in ListRowSource, aggregierte Gruppenzeilen in DefaultTableView, und die Gruppierung ist Teil des persistierten TableViewState. TableViewControl verfügte jedoch über kein Statusfeld und keinen Befehl dafür, der Client rendert keine Gruppenzeilen, und TableElement.Config bot keine Möglichkeit, eine Gruppierung zu deklarieren.
3. Die Aktivierung war nur über Maus und Tastatur möglich, und der Baum verfügte über keine Tastaturauswahl
Doppelklick und Enter sind die einzigen Aktivierungsgesten; beide gibt es auf einem Touch-Gerät nicht, und beide sind nicht sichtbar, sodass ein Benutzer sie kennen muss. Listen, die einen Detailrahmen öffnen, wie beispielsweise die Tabellenkacheln der Drill-Down-Demo, verfügten daher weiterhin über eine explizite „Öffnen“-Schaltfläche in der Symbolleiste. In der Baumstruktur bewegten die Pfeiltasten lediglich eine clientseitige Fokusmarkierung: Die Auswahl folgte nicht, sodass eine Baumstruktur mit Einzelauswahl ohne Aktivierung nicht per Tastatur bedient werden konnte, und die Eingabetaste wirkte auf den fokussierten Knoten, während der Auswahlkanal einen anderen enthielt.
Lösung
Zeilenaktivierung
<table> und <tree> erhalten einen Aktivierungsbefehl, eine gewöhnliche ViewCommand-Konfiguration, die mit der aktivierten Zeile (oder dem Business-Objekt des Knotens) als Eingabe ausgeführt wird:
{{{#!xml <table rows="…" selection="ticket">
<on-activate>
<open-dialog dialog-view="ticket-detail.view.xml" bind-input-to="model"/>
</on-activate>
</table> }}}
- Der Client sendet bei einem Doppelklick und beim Drücken der Eingabetaste den Befehl „activate“ mit der Zeile, während sich der Tastaturcursor auf dieser Zeile befindet (ein Baumknoten: Doppelklick oder Eingabetaste auf dem fokussierten Knoten, auf den auch ein Klick den Fokus setzt); der Server wählt zunächst die Zeile aus, sodass der Auswahlkanal sie enthält, und führt dann den Befehl mit der Zeile als Eingabe aus. Es gelten die Ausführungsregeln des Befehls selbst; eine Zeile, für die der Befehl nicht ausführbar ist, löst keine Aktion aus. Ein Doppelklick innerhalb eines interaktiven Zellenelements gehört zu diesem Element.
- Die Aktivierung wird für skriptgesteuerte Tests als `activateByKey ` unter Angabe des Geschäftsobjekts der Zeile aufgezeichnet, ähnlich wie bei `select`.
- ViewCommandModel.forCommand(ViewContext, ViewCommand, ViewCommand.Config) und ViewCommandModel.execute(ReactContext, Object input) führen einen konfigurierten Befehl mit einer vom Aufrufer bereitgestellten Eingabe aus; die Schaltfläche, die Symbolleisten, die App-Leiste und die Aktivierung nutzen diese eine Konstruktion eines Befehlsmodells gemeinsam.
Gruppierung der Benutzeroberfläche
- TableElement.Config erhält für die anfängliche Gruppierung den Wert „group-by=‘column’“; der Benutzer ändert dies über das Menü der Spaltenüberschrift („Nach dieser Spalte gruppieren“, „Gruppierung aufheben“) sowie über die Spaltenauswahl, wo jede Spalte über einen Schalter zum Ein- und Ausschalten der Gruppierung verfügt. Die Auswahl wird zusammen mit dem restlichen Tabellenstatus unter dem Personalisierungsschlüssel der Tabelle gespeichert.
- TableViewControl macht die Gruppierung in seinem Status sichtbar und akzeptiert einen Gruppierungsbefehl. Gruppenüberschriften werden als erweiterbare Zeilen auf Ebene 0 mit ihren Elementen auf Ebene 1 über die dem Client bereits vorliegende Baumdarstellung bereitgestellt, sodass das Zusammenklappen einer Gruppe dem Zusammenklappen eines Knotens entspricht. Eine Kopfzeile zeigt den Gruppenwert an, der vom eigenen Zell-Renderer der gruppierten Spalte gerendert wird (ein Klassifikator als Beschriftung, ein Datum in seinem Format), die Anzahl der Elemente sowie in jeder anderen Spalte das Aggregat, das der Aggregator der Spalte liefert – oder gar nichts. Eine Kopfzeile steht für kein Objekt: Durch Auswählen und Aktivieren wird ihre Erweiterung umgeschaltet, und der Auswahlkanal erhält niemals eine Gruppe. Beim Gruppieren und Aufheben der Gruppierung bleibt die Auswahl erhalten, da die Datenzeilen unverändert bleiben; nur ein Schlüssel, der nicht mehr in den Zeilen enthalten ist, wird entfernt (#29535).
- Das Sortieren erfolgt innerhalb von Gruppen, das Filtern vor dem Gruppieren. Mehrspaltiges Gruppieren ist nicht vorgesehen; die Benutzeroberfläche bietet eine Spalte an.
Aktivierungsschaltfläche und Tastaturauswahl
- Ein <table> mit einem <on-activate> -Befehl zeigt eine angeheftete Spalte am Ende an, mit einer Chevron-Schaltfläche pro Zeile, die den Aktivierungsbefehl für diese Zeile ausführt. Die Schaltfläche folgt den Ausführungsregeln des Befehls pro Zeile (eine abgelehnte Zeile zeigt eine deaktivierte Schaltfläche an, eine ausgeblendete Zeile keine Schaltfläche), ihr Tooltip ist die Bezeichnung des Befehls („Öffnen“, wenn der Befehl keine angibt), und sie macht die Aktivierung auf Touch-Geräten sichtbar und nutzbar, auf denen weder Doppelklick noch die Eingabetaste vorhanden sind. Die Spalte ist nicht auswählbar, gruppierbar, in der Größe veränderbar oder kann nicht fixiert werden; eine Ansicht, die die Gesten nutzen möchte, deaktiviert sie einfach mit activation-button="false".
- Die Schaltflächenspalte ist eine Instanz einer allgemeinen Zeilenbefehlsspalte (RowCommandColumn, com.top_logic.layout.view.table): eine fixierte Spalte pro ViewCommandModel, das ein Aufrufer für jede Zeile bereitstellt, wobei über die Zellsteuerungsschnittstelle (CellContent.Raw mit einer CellControlFactory) eine reine Symbolschaltfläche gerendert wird. ViewCommandModel.executability(Object input) stellt die Ausführbarkeit pro Eingabe bereit, anhand derer die Schaltfläche ihren Zustand bestimmt; TableElement erstellt ein Modell für <on-activate> und übergibt es sowohl an die Aktivierungsgeste als auch an die Spalte, und RowSetTableControl.setTrailingColumns(…) fügt solche Spalten in der bearbeitbaren Tabellenvariante an.
- Eine Spalte kann am Ende der Tabelle fixiert werden (Column.pinnedEnd(), DefaultColumn.Builder.pinnedEnd(true)). Eine fixierte Spalte kann weder eingefroren noch ausgewählt werden; `DefaultTableView` hält sie unabhängig von der gespeicherten Reihenfolge hinter allen anderen Spalten, das „frozen“-Präfix erreicht sie nie, und das Verschieben, Ändern der Größe, Ausblenden sowie Gruppieren anhand dieser Spalte werden verweigert. Der Client stellt solche Spalten am rechten Rand von Kopfzeile und Hauptbereich als „sticky“ dar, sodass sie sichtbar bleiben, während die Tabelle horizontal gescrollt wird; die Spalte, die sich über die verbleibende Breite erstreckt, ist die letzte nicht fixierte Spalte. Das Einfrieren von Spalten auf der linken Seite bleibt unverändert.
- Der Baum übernimmt das Tastaturmodell der Tabelle: Die Pfeiltasten sowie „Home“ und „End“ wählen im Einzelauswahlmodus den Knoten aus, zu dem sie springen; im Mehrfachauswahlmodus bewegen sie nur den Cursor, „Shift“ erweitert die Auswahl und die Leertaste wechselt den Cursorknoten. Die Eingabetaste aktiviert den Cursor-Knoten, sodass der aktivierte Knoten immer der ausgewählte ist.
Anzeige der Befehlsspalte, Cursorring, Breite an Inhalt anpassen
- Die Zeilen und die Kopfzeile füllen die Tabelle aus, auch wenn die Spalten schmaler sind als diese: Die letzte Spalte, die der Benutzer anordnet, dehnt sich in den Rest hinein, in der Kopfzeile genau wie in den Zeilen, sodass eine am Ende fixierte Spalte (die Chevron-Spalte) immer bündig am rechten Rand sitzt. Das Zahnrad des Spaltenauswahlfelds, das rechts neben der Kopfzeile reserviert ist, verschwindet überall dort, wo die Tabelle in einer fixierten Spalte endet: Das Zahnrad befindet sich dann in der Überschrift dieser Spalte, die ohnehin keine Beschriftung enthält. Bei einer Tabelle ohne fixierte Spalte bleibt das Zahnrad wie bisher über dem rechten Rand der Kopfzeile.
- Eine Spalte kann eine spaltenweite CSS-Klasse enthalten (Column.cssClass(), DefaultColumn.Builder.cssClass(String)), die der Client auf jede Zelle der Spalte anwendet, einschließlich ihrer Überschrift. RowCommandColumn nutzt dies, um den Textabstand seiner Zellen aufzuheben und eine rahmenlose Befehlsschaltfläche mit Platz um das Symbol herum zu zentrieren; der Rahmen erscheint nur unter dem Mauszeiger.
- Der Ring, der die Zeile des Tastaturcursors markiert, wird auf die Zellen statt auf die Zeile gezeichnet, sodass die fixierten Spalten links und die angehefteten Spalten rechts, die klebrig sind und über die Zeile hinausragen, ihn ebenfalls anzeigen.
- Breite an Inhalt anpassen: Die Option „Breite an Inhalt anpassen“ im Menü einer Spaltenüberschrift sowie ein Doppelklick auf den Größenänderungsgriff der Spalte passen die Spalte an die Breite des derzeit angezeigten breitesten Zellinhalts an – einschließlich der Überschrift – und behalten diese Einstellung wie eine manuell angepasste Breite auch bei der Tabellenanpassung bei. Fixierte Spalten behalten ihre feste Breite bei.
Ebenfalls auf dem Weg zur Behebung
„DefaultTableView“ teilte seiner Zeilenquelle die anfängliche Sortierung mit, nicht jedoch die anfängliche Gruppierung, sodass eine konfigurierte Gruppierung im Status gespeichert und nie angewendet wurde; beide werden nun an die Quelle übermittelt.
Dokumentation und Demo
docs/faq/react-view-layer.md dokumentiert die Zeilenaktivierung, die Aktivierungsschaltfläche, fixierte Spalten, die CSS-Klasse auf Spaltenebene, die Anpassung an den Inhalt und die Gruppierung. com.top_logic.demo.react: Die Objektliste gruppiert ihre Tickets nach Status; die Tabelle „Attribute“ öffnet bei Aktivierung den Detail-Dialog und bietet über ihr Kopfmenü eine Gruppierung an; eine Baum-Demo-Ansicht aktiviert Knoten; die Kontotabellen der Kachel-Drilldown-Demos schieben den Personenrahmen bei Aktivierung (<on-activate class="…NavigatePushCommand">) anstelle der Verwendung einer „Öffnen“-Schaltfläche in der Symbolleiste. Tests: TestTableActivation, TestTableGrouping, TestPinnedColumns (tl-layout-react), TestTableElement, TestTreeElement, TestRowCommandColumn (tl-layout-view), TestGrouping (tl-core).