enhancement
major
minor
major
minor
major
#29557
React-View-Befehle: Der „ExecutableState“-Wert eines deaktivierten Befehls wird niemals an den Client übermittelt, und es gibt neben „visible-if“ keine „disabled-if“-Regel.
Betrifft 8.0.0-SNAPSHOT (11.09.2026), tl-layout-view / tl-layout-react.
1. Ein deaktivierter Befehl zeigt keinen Grund an
ViewCommandModel.getTooltip() (com.top_logic.layout.view/src/main/java/com/top_logic/layout/view/command/ViewCommandModel.java:159-165) gibt nur den konfigurierten Tooltip zurück. Der Grund für einen deaktivierten `ExecutableState` – den jede `ViewExecutabilityRule` erzeugt, einschließlich des engine-eigenen `<null-input-disabled/> ` – wird niemals an den Client gesendet: Das DOM der deaktivierten Symbolleisten-Schaltfläche enthält weder ein `title` - noch ein `tooltip`-Attribut.
Daher existiert das Muster „deaktiviert mit Angabe eines Grundes“ der klassischen Benutzeroberfläche (mit der Maus über die graue Schaltfläche fahren, Grund lesen) in der React-Ansichtsebene nicht. Die Anwendungsumgehung besteht aus einem statischen <tooltip> auf dem Befehl, der die Bedingung benennt – ein einziger Text für jeden möglichen Grund, den die Regeln angeben könnten.
Erwartet: Der Tooltip eines deaktivierten Befehls ist der Grund für die Deaktivierung (wie bei „ButtonControl“ der klassischen Benutzeroberfläche), der konfigurierte Tooltip, solange der Befehl ausführbar ist.
2. Keine „disabled-if“-Regel
tl-layout-view enthält <visible-if expr="…"> (blendet einen Befehl aus) und <null-input-disabled/>, jedoch keine Regel, die einen Befehl sichtbar hält und ihn mit einem durch einen TL-Script-Ausdruck berechneten Grund *deaktiviert* – das Gegenstück zu „visible-if“ für „Sie dürfen dies noch nicht ausführen“. Die Anwendung „Expenses“ enthält eine kleine allgemeine Regel (DisabledIf: eine „ViewExecutabilityRule“ mit einem Ausdruck, der mit der Befehlseingabe aufgerufen wird und bei Ausführbarkeit null oder den Grund als „ResKey“ bzw. String zurückgibt; src/main/java/com/top_logic/apps/expenses/view/DisabledIf.java in bhu/expenses auf Gitea), die als @TagName("disabled-if") in die Engine übernommen werden könnte.
Zusammen mit Punkt 1 bietet dies den Autoren von Ansichten das Standardpaar: Ausblenden, was nicht zum Benutzer gehört, und mit einer Begründung deaktivieren, was der Benutzer noch nicht tun darf.
3. Eine Änderung des Grundes zwischen zwei deaktivierten Zuständen wird ignoriert
ViewCommandModel.updateExecutableState weist den neuen Zustand zu und wird nur ausgelöst, wenn sich visibility() vom vorherigen Zustand unterscheidet. Eine Regel, die zunächst „nichts ausgewählt“ und dann „das ausgewählte Ticket ist geschlossen“ angibt, gibt daher den zweiten Grund niemals weiter, und getExecutableState() liefert den veralteten Wert zurück.
Lösung
Tooltip eines deaktivierten Befehls. ViewCommandModel.getTooltip() liefert, solange der Befehl sichtbar, aber nicht ausführbar ist, den aufgelösten Grund (ExecutableState.getI18NReasonKey()) des aktuellen Zustands; solange er ausführbar ist (oder der Zustand keinen Grund enthält), weiterhin den konfigurierten Tooltip. Das Button-Control (ReactButtonControl) sendet den Tooltip ohnehin bei jeder Zustandsänderung des Modells neu an den Client; der Client zeigt den Tooltip auch bei deaktivierten Buttons an, sodass dort keine Änderung erforderlich war.
Zustandsvergleich. `ExecutableState ` (final, unveränderlich) verfügt nun über `equals()`/`hashCode() ` für Sichtbarkeit und Grund (`compareTo ` bleibt wie bisher nur über die Sichtbarkeit definiert). ViewCommandModel.updateExecutableState wird ausgelöst, sobald der neue Zustand ungleich dem alten ist – also auch bei einem geänderten Grund zwischen zwei deaktivierten Zuständen.
Neue Regel <disabled-if expr="…"/> (com.top_logic.layout.view.command.DisabledIf, Gegenstück zu <visible-if>): Die TL-Script-Funktion wird mit dem Eingabewert des Befehls aufgerufen. Liefert sie null oder false, bleibt das Kommando ausführbar. Ein ResKey oder ein String wird zum Grund des deaktivierten Zustands (und damit zum Tooltip). Ein bloßes „true“ deaktiviert mit dem generischen Grund der Engine („not executable“), sodass die Regel auch als reines Prädikat verwendet werden kann. Eine Regel, die über das Eingabeobjekt hinaus andere Objekte ausliest, benötigt deren Typen in den „observed-types“ des Befehls, damit deren Änderungen die Regel neu auswerten.
<executability>
<null-input-disabled/>
<disabled-if expr="t -> if($t.get(`demo.tickets:Ticket#status`) == `demo.tickets:TicketStatus#closed`, #('Geschlossene Tickets können nicht gelöscht werden.'@en, 'Geschlossene Tickets können nicht gelöscht werden.'@de), null)"/>
</executability>
Demo. Die Tickets-Ansicht der React-Demo (tl-demo-react) wendet die Regel auf den Löschbefehl an: Ohne Auswahl zeigt die deaktivierte Schaltfläche „Kein Bezugsobjekt ausgewählt“ an, bei einem geschlossenen Ticket den oben genannten Grund.