enhancement
major
minor
major
minor
minor
#29506
Eine Dashboard-Kachel kann nicht der Einstiegspunkt sein, nach dem sie aussieht: Weder <tile> noch <card> führen zu einer Aktion.
Gemeldet über die „Consulting“-Anwendung in Version 8.0.0-alpha7 (React-View-Benutzeroberfläche, Issue #94).
Das Problem
Eine Cockpit-Kachel, die eine Anzahl anzeigt, ist genau das, worauf ein Leser abzielt, wenn er wegen dieser Anzahl hier ist. Derzeit kann sie nicht darauf reagieren: Weder die Kachel noch die darin enthaltene Karte können eine Aktion ausführen.
CardElement.Config -> TITLE, VARIANT, PADDING TileElement.Config -> ID, WIDTH, ROW_SPAN, CONTENT
Unsere Projektansicht zeigte, was das bedeutet. Sie enthielt vier Cockpit-Kacheln – //Dokumente 13//, //Phasen 4//, //Aufgaben 29//, //Beteiligte 5// – und, da die Kacheln nichts öffnen konnten, vier Symbolleisten-Schaltflächen mit denselben vier Namen daneben. Somit wurde jeder Teil des Projekts doppelt angeboten, die Symbolleiste wies am Ende fünf gleichwertige Schaltflächen auf und hatte daher keine primäre Aktion, und die Kachel, die die Nummer trug, führte beim Anklicken keine Aktion aus. Benutzer klicken auf die Nummer.
Was heute existiert
Ein <button> innerhalb der <card>, da <button> jeden ViewCommand als Aktion akzeptiert und NavigatePushCommand einer davon ist:
{{{#!xml <tile id="tasks" width="half">
<card padding="COMPACT">
<title><en>Aufgaben</en></title>
<text input="taskCount"/>
<button appearance="LINK">
<action class="com.top_logic.layout.view.tiles.NavigatePushCommand" view="consulting/tasks.view.xml" .../>
</button>
</card>
</tile> }}}
Das haben wir ausgeliefert, und es ist eine echte Verbesserung – „count“ und „way“ befinden sich nun an einer Stelle. Es ist jedoch nicht dasselbe:
- Das Ziel ist ein Link, der einige Dutzend Pixel breit ist, nicht die Kachel. Die große, auffällige Fläche bleibt unverändert, sodass ein versehentlicher Klick nach wie vor wahrscheinlich ist.
- Die Kachel vergrößert sich um die Höhe einer Zeile. Wir mussten bei allen fünf Karten „padding=“COMPACT““ festlegen, um die eigenen Felder des Objekts oberhalb der Falz zu halten.
- Auf der Karte taucht dasselbe Wort schließlich dreimal auf – in der Überschrift, im Wert und in einem Link, der sein Ziel benennen muss, um für sich allein verständlich zu sein („Offene Aufgaben“).
Vorgeschlagene Form
Eine Aktion auf <tile> statt auf <card>, da die Kachel die Oberfläche darstellt:
{{{#!xml <tile id="tasks" width="half" >
<action class="com.top_logic.layout.view.tiles.NavigatePushCommand"
view="consulting/tasks.view.xml"
bind-input-to="project"
input="project"
/>
<card>
<title><en>Aufgaben</en></title>
<text input="taskCount"/>
</card>
</tile> }}}
Da das heutige Verhalten darin besteht, keine Aktion auszuführen, ändert sich nichts am Bestehenden. Punkte, die beim Design zu klären sind:
- Die Kachel benötigt die Affordanzen eines Steuerelements, nicht nur einen Klick-Handler: einen Hover-Zustand, einen sichtbaren Fokusring, die Aktivierung über die Eingabetaste und die Leertaste sowie einen barrierefreien Namen – vermutlich den Titel der Karte selbst, da dies die einzige Beschriftung ist, die der Leser sieht.
- <executability> sollte so funktionieren wie bei Symbolleistenbefehlen (<null-input-disabled/> wird bei unseren vier Schaltflächen verwendet), und eine nicht ausführbare Kachel sollte dies auch deutlich anzeigen, anstatt den Klick stillschweigend zu ignorieren.
- Verschachtelte interaktive Inhalte müssen definiert werden: Eine anklickbare Kachel, die zudem eine Schaltfläche oder einen Link enthält, ist der Fall, bei dem es zuerst zu Problemen kommt. Entweder sollte man diese Kombination verbieten oder das Ereignis am inneren Steuerelement stoppen.
- Eine Kachel, die ein Ziel darstellt, sollte von einer unterscheidbar sein, die kein Ziel ist – unsere //Client//-Kachel dient ausschließlich der Anzeige und befindet sich neben vier Kacheln, bei denen dies nicht der Fall ist.
Warum nicht direkt in die Anwendung integrieren?
Ein eigenes UIElement würde bedeuten, die Darstellung von Karten und Kacheln außerhalb des Frameworks neu zu erstellen, zusammen mit der Fokusverwaltung, der Tastaturaktivierung und der ARIA-Verknüpfung – dieselbe Argumentation wie in #29491 und #29500. Unsere Anwendung verzichtet bewusst darauf.
Verwandte Themen
- #29501 – Eine Tabellenzeile per Doppelklick oder Enter aktivieren. Gleiches Problem: Die Oberfläche, auf die der Benutzer zielt, ist nicht diejenige, die reagiert.
- #29500 – Kein Overlay „Master-Detail“.
- #29475 – Keine konfigurierbare Spaltenbreite bei <table>.
Lösung
Ein <tile> eines <dashboard> akzeptiert optional ein <action class="..."/>: einen beliebigen ViewCommand, der genau wie die Aktion eines <button> oder das <on-activate> eines <table> konfiguriert ist, mit input, <executability>, observed-types und <label>. Eine Kachel ohne Aktion verhält sich wie bisher.
Verhalten einer Kachel mit einer Aktion
- Die gesamte Kachel ist das Ziel: Ein Klick an einer beliebigen Stelle darauf führt den Befehl aus. Ein Klick, der auf einem interaktiven Steuerelement innerhalb der Kachel beginnt – einer Schaltfläche, einem Link, einem Eingabefeld, einem ARIA-Widget –, wird diesem Steuerelement überlassen, sodass eine Karte, die ebenfalls eine Schaltfläche enthält, weiterhin funktioniert.
- Die Kachel ist ein Steuerelement für die Tastatur und für assistive Technologien: Sie ist ein Tabulator-Haltepunkt, die Tasten „Enter“ und „Leertaste“ führen den Befehl aus, sie zeigt einen Fokusring an und verfügt über einen barrierefreien Namen – den <label> der Aktion, sofern konfiguriert, andernfalls „Öffnen“ in Kombination mit dem Titel der Karte oder des Panels innerhalb der Kachel.
- Die Kachel folgt der Ausführbarkeit des Befehls genauso wie eine Symbolleisten-Schaltfläche. Solange die Regeln den Befehl deaktivieren, zeigt die Kachel keinen Hover-Effekt an, ignoriert den Klick und gibt den Grund der Regel als Tooltip an. Solange die Regeln den Befehl ausblenden, ist die Kachel eine reine Anzeige-Kachel.
- Eine Kachel mit einer ausführbaren Aktion reagiert auf den Mauszeiger: Der Cursor fungiert als Zeiger, und die Kachel wird beim Bewegen des Mauszeigers darüber hervorgehoben. Die Engine zeichnet kein Symbol über den Inhalt; eine sichtbare Markierung wird durch den Inhalt der Kachel selbst gesetzt.
- Im Bearbeitungsmodus des Dashboards (Per Ziehen neu anordnen) wird die Aktion ausgesetzt.
Kartenkopf-Slot und Symbolelement
- <card> nimmt <header-content> entgegen: Elemente, die am rechten Rand der Kartenüberschrift nach dem Titel gerendert werden – ein Symbol, das die Karte als Einstiegspunkt kennzeichnet, ein Abzeichen, eine Schaltfläche.
- Das neue Element <theme-icon image="css:..."/> rendert ein Themen-Symbol (Schriftart-Symbol oder Bildressource) eigenständig, dekorativ oder benannt durch seinen Tooltip. (Das Tag-Symbol wird von der icon-Eigenschaft mehrerer Elemente mit einem Standard-Container übernommen und kann kein Inhalts-Tag sein.)
Technische Hinweise
- TileElement.Config#getAction() und das daraus mit ViewCommandModel.forCommand erstellte ViewCommandModel, das an das Dashboard-Steuerelement angehängt und von diesem getrennt wird; TitledElement (implementiert durch CardElement und PanelElement) liefert den Titel für den Fallback des „accessible-name“-Attributs.
- ReactDashboardControl.Tile trägt das Befehlsmodell; das Dashboard-Steuerelement bietet einen Befehl zur Aktivierung auf Client-Seite (ActivateTileArguments) und veröffentlicht die Kachelbeschreibungen (action: {label, disabled, tooltip}) bei einer Zustandsänderung des Modells erneut.
- Der Client (TLDashboard) rendert ein visuell ausgeblendetes, aber fokussierbares `<button>` innerhalb einer aktionsfähigen Kachel für den Namen, die Tastatur und den deaktivierten Zustand; die Kachel selbst verarbeitet den Mauszeiger, wobei der Test auf interaktive Nachkommen gemeinsam mit der Tabelle genutzt wird (interactive.ts).
- IconElement / ReactIconControl / TLIcon.
- React-Demo (tl-demo-react): Der Projektrahmen ist ein Cockpit-Dashboard (Projekt-Kachel nur zur Anzeige, Meilenstein- und Notizen-Kacheln als Einstiegspunkte mit einem Chevron im Kartenkopf; die Notizen-Kachel wird mit einer Begründung abgelehnt, solange das Projekt keine Notizen enthält, und wird aktiviert, sobald eine Notiz erstellt wird). Der Projekt-Drilldown nutzt die Zeilenaktivierung anstelle von „Öffnen“-Befehlen in der Symbolleiste, die Meilensteinliste ist ein „Pushed Frame“ (auch für Anzeigeziele), und Projekte, Meilensteine und Notizen können erstellt und gelöscht werden.