enhancement
major
minor
major
minor
major
#29615
TL-Ansichten: Ein seitenübergreifendes „ <form> “ ist nicht am Füllvertrag beteiligt, sodass ein darin enthaltenes geteiltes oder ausfüllendes Panel entsprechend seinem Inhalt dimensioniert wird.
Problem
Die Ticket-Seite des Issue-Trackers tl-dev zeigt ein Objekt in drei Bereichen an: einer Kopfzeile (Schlüssel, Zusammenfassung, Status, Typ), einer Hauptspalte (Beschreibung, Anhänge, Diskussion) und einer Seitenspalte mit Karten (Klassifizierung, Personen, Planung, Kontext, Verlauf, Links). Jeder Bereich ist ein <form input="ticket">, sodass die Seite drei Sätze von „Bearbeiten“ / „Speichern“ / „Abbrechen“ enthält und ein Benutzer, der die Zusammenfassung und die Priorität bearbeitet, zweimal speichern muss. Gewünscht: ein einziger Bearbeitungsmodus für die Seite. Anhand des Snapshots vom 16.09.2026 wurden zwei Ansätze ausprobiert.
1. Drei Formulare, die sich einen Bearbeitungsmodus-Kanal teilen (keine Lösung)
FormElement.Config.getEditMode() (editMode="ch") bindet den Modus eines Formulars bidirektional an einen Kanal. Alle drei Formulare wechseln zwar gemeinsam den Modus, doch ein „Speichern“ in einem Formular verwirft die Eingaben der beiden anderen: FormControl.handleEditModeChannelChanged ruft executeCancel() auf, wenn der Kanal auf „false“ wechselt, und ein Formular, das speichert, veröffentlicht genau dies in discardEditSession. Beobachtet: Die Zusammenfassung in der Kopfzeile hat sich geändert, die Priorität in einer Seitenkarte hat sich geändert, „Speichern“ in der Kopfzeile – die Zusammenfassung wird gespeichert, die Priorität kehrt nach einem Neuladen zu ihrem alten Wert zurück. „mode-switch=“false““ in den anderen Formularen blendet lediglich deren Schaltflächen aus (FormElement.contributeEditCommands wird übersprungen); der Kanal-Listener bleibt bestehen. Keine Aktion speichert den Zustand eines anderen Formulars: <store-form-state> / <discard-form-state> lesen ViewContext.getFormModel(), ihr eigenes Formular, und ein verschachteltes <form> wird nicht als FormParticipant eines äußeren registriert (nur AttributeFieldControl und AbstractCompositionControl tun dies).
Der Bearbeitungsmodus-Kanal ist ein Moduswechsel, keine gemeinsame Bearbeitungssitzung. Drei Formulare für ein Objekt sind die falsche Struktur für einen Bearbeitungsmodus; die richtige Struktur ist ein Formular (2.).
2. Ein Formular, das sich über die gesamte Seite erstreckt (die richtige Struktur, scheitert jedoch am Layout)
Ein übergeordnetes <panel> (Titel, Workflow-Befehle) → <form input="ticket"> → das vorhandene <split-panel> mit seinen Panels und Karten. Dies ist funktional korrekt: ein „Bearbeiten“ / „Speichern“ / „Abbrechen“ neben den Workflow-Befehlen, Felder werden über Panels, geteilte Panels und Karten gebunden (DefaultViewContext.childContext gibt das Formularmodell weiter), ein „Speichern“ speichert Zusammenfassung, Beschreibung und Priorität in einer Transaktion, und die <object-list> der Diskussion mit ihrem eigenen Erstellungsformular funktioniert weiterhin verschachtelt darin.
Beim Layout tritt jedoch ein Fehler auf: Das Formular-Steuerelement `TLFormLayout` ist ein CSS-Raster mit eigenem Abstand, das nicht am „fill“-Vertrag teilnimmt (react-src/bridge/fill.ts: kein `useFillHost`), und `FormElement.Config` verfügt über keine „fill“-Option. Ein <split-panel> innerhalb des Formulars wird daher anhand seines Inhalts dimensioniert und nicht anhand der vom Container bereitgestellten Höhe: Das gemessene .tlSplitPanel misst 2284 px innerhalb eines 844 px breiten Tile-Stack-Rahmens, der Kopfbereich ist ein ca. 570 px breiter leerer Streifen, und die Seite scrollt als Ganzes. Die CSS-Klasse wird von TLFormLayout nicht angewendet, sodass sie auf der App-Seite nicht erreicht wird.
Lösung
Ein <form> nimmt am „fill“-Vertrag als Container teil, der sich an seine untergeordneten Elemente anpasst, so wie es <inset>, <stack> und der Tile-Stack-Rahmen tun: TLFormLayout meldet dies über „useFillHost“ und stellt den Host seinen untergeordneten Elementen zur Verfügung. Solange ein Kind die Füllung meldet (ein <split-panel>, ein <panel fill="true">), trägt das Formular die Füllklasse und ordnet sich als bündige Spalte an (tlFormLayout--fill: kein Seiten-Inset, das füllende Kind nimmt die Höhe ein, die das Formular bereitstellt, jedes andere direkte Kind behält die Höhe seines Inhalts bei), sodass das Kind die Höhe einnimmt, die der Container des Formulars bereitstellt, und seinen eigenen Inhalt scrollt. Um Inhalte herum, die seine eigene Größe haben, ist das Formular das gepolsterte, responsive Raster, das es schon immer war. Keine Konfigurationsoption: Die Entscheidung ergibt sich aus dem Inhalt, genau wie bei den anderen „fill“-folgenden Containern.
Felder innerhalb der Bereiche eines solchen Formulars
Ein Formular, das bündig um ein geteiltes Panel herum angeordnet ist, legt keines seiner Felder selbst an, und ein <panel> fügt seinem Inhalt keinen Abstand hinzu (Abstandsmodell: Container führen niemals Abstände ein). Die Felder jedes Bereichs stehen daher in einem <fields> -Raster (FieldsElement), das sie vom Rand des Bereichs versetzt, über die responsiven Spalten verteilt und sie die Spaltenbreite ausfüllen lässt – dasselbe Raster, das ein einfaches <form> um seine Felder herum rendert. Ein Bereich, der schmaler ist als die Spalten des Standardrasters, nimmt den Wert „max-columns="1"“ an, sodass die Position der Beschriftung der Breite des Bereichs folgt (neben dem Eingabefeld, solange es breit ist, darüber, sobald es schmal ist):
<form input="ticket">
<split-panel><panes>
<pane><panel>
<fields max-columns="1">
<field attribute="summary"/>
<field attribute="description"/>
</fields>
</panel></pane>
...
</panes></split-panel>
</form>
Ein <fields> -Raster innerhalb eines <form> folgt dem Bearbeitungsmodus des Formulars: Die Feldelemente (Markierung für Pflichtfelder, Schreibschutzanzeige, Sichtbarkeit von Fehlern und Hilfetexten) lesen den Schreibschutzstatus des nächstgelegenen Rasters, sodass das Raster das Formular über einen FormModelListener (FormLayoutEditModeBinding, das in `FieldsElement.createControl ` gebunden wird, wenn der Ansichtskontext ein Formularmodell enthält; der Listener wird entfernt, wenn das Raster entsorgt wird). Ein <fields> außerhalb eines Formulars ist wie bisher niemals schreibgeschützt; ein <form>, das in einem anderen <form> verschachtelt ist, behält seinen eigenen Bearbeitungsmodus bei. FormControl.fireFormStateChanged benachrichtigt eine Kopie seiner Listener-Liste, sodass die Abmeldung eines Listeners während der Benachrichtigung unbedenklich ist. Test: TestFieldsElement.
Formulare, die eine Bearbeitungssitzung über mehrere Objekte hinweg gemeinsam nutzen, sind nicht Gegenstand dieses Tickets.
Dokumentiert in docs/faq/react-view-layer.md (der Punkt zu <fields> und der Abschnitt zum „Fill Contract“). Demo in tl-demo-react: Eintrag „Page form“ in der Seitenleiste (demo/form-fill-demo.view.xml) – eine Auswahltabelle neben einem Panel, dessen <form> ein verschachteltes <split-panel> umschließt; jeder Bereich ist ein <panel>, dessen Felder in einem einspaltigen <fields> -Raster angeordnet sind; die Größe der Bereiche wird durch den Rahmen bestimmt, und die einzige Schaltfläche „Bearbeiten / Speichern / Abbrechen“ in der Panel-Symbolleiste speichert beide Bereiche in einer Transaktion.