enhancement
major
minor
major
minor
minor
#29663
TL-Ansichten: Ein „ <form> “ wird nicht mehr eingebettet; bei einem „ <fields> “-Raster innerhalb eines Formulars wurde die Seite zweimal eingebettet
Problem
In einem seitenübergreifenden <form>, das wie in #29615 vorgeschlagen gestaltet ist – ein <fields> -Raster für einen Kopfbereich über einem <columns> -Layout aus Karten –, sind die Felder des Kopfbereichs um 24 px weiter eingerückt als die darunter liegenden Karten (TL Development-App, Ticket-Seite, Snapshot-Build 42, 1600x900). Die Seite erscheint dadurch als zwei nicht fließend angeordnete Blöcke.
Ursache
FieldsElement.createControl rendert sein Raster als ReactFormLayoutControl, d. h. als .tlFormLayout, und .tlFormLayout verfügt über padding: var(--page-inset) („Ein Formular braucht seinen Freiraum“). Da es in das form-eigene .tlFormLayout verschachtelt ist, wird der Abstand zweimal angewendet: einmal durch das Formular, einmal durch das Raster. Das Formular verzichtet nur in den Varianten „--flush“ (einzige Tabelle) und „--fill“ (beherbergt einen Füllbereich) auf seinen Abstand; die Karten der Spalten (.tlPanel--card) bringen ihren eigenen reduzierten Abstand mit, sodass ihre Ränder und die Ränder des Kopfzeilen-Rasters nicht übereinstimmen.
Das Formularraster war das einzige Layout der Ansichtsebene, das sich selbst mit Abstand füllte; das Abstandsmodell besagt ansonsten: Container füllen niemals selbst Abstand, der Freiraum wird explizit festgelegt (<inset>).
Lösung
- Ein Formularraster (<form>, <fields> und jedes auf ReactFormLayoutControl basierende Steuerelement, z. B. <config-form>, <config-editor>) ist ein einfaches Layout und fügt keinen eigenen Abstand mehr ein. Ein in einem Formular verschachteltes <fields> -Raster richtet sich daher am restlichen Inhalt des Formulars aus.
- <form> und <fields> akzeptieren die neue Option with-inset="true": Das Raster wird dann genau wie ein <inset> -Element um es herum in einen Versatz eingeschlossen (Seitenversatz; innerhalb eines Kartenpanels der reduzierte Versatz der Karte). Der Standardwert ist „false“. (Der Name „inset“ ist nicht zulässig: Er würde mit dem Inhaltselement <inset> kollidieren.)
- Die Sonderfälle, die nur dazu dienten, den Selbstabstand wiederherzustellen, wurden entfernt: die Variante „--flush“ mit ihrer Heuristik für „sole-table“/„bare-panel“ (der Zustand „bare-panel “ existiert nicht mehr) und das Zurücksetzen des Abstands bei der Variante „--fill “. Ein Formular, dessen einziger Inhalt eine rahmenlose, bearbeitbare Tabelle ist, füllt seinen Container stattdessen über den „fill“-Vertrag aus (das rahmenlose Tabellenfeld setzt „fill“), sodass die Tabelle intern weiterhin scrollbar bleibt.
- In Java erstellte Formulare (I18N-Editor-Dialog, Tabellen-Spaltenfilter-Dialog inkl. skriptgesteuerter Filter) umschließen ihren Formularkörper mit einem „inset“.
- Alle Engine- und Demo-Ansichten (.view.xml) wurden migriert: Formulare/Raster, die direkt in einem Panel-Körper, einer Registerkarte, einem Dialog, einem geteilten Fenster oder einem Detailbereich liegen, erhalten „with-inset=“true“; <config-form>/`<config-editor>` werden in <inset> eingeschlossen; Formulare, die eine einzige bearbeitbare Tabelle enthalten, sowie Formulare, die sich über mehrere Bereiche erstrecken, und Raster innerhalb eines Inset-Formulars bleiben ohne Inset.
- Demo (tl-demo-react): Demos → „Seitenformular mit Karten“ zeigt ein Seitenformular mit einer Feldüberschrift über Spalten von Kartenfeldern; Überschriftenfelder und Kartenränder teilen sich eine linke Kante.
Migration
Formulare in Anwendungsansichten verlieren ihren automatischen Abstand zum Containerrand. Überall dort, wo ein `<form> ` oder `<fields>` direkt an einem Rand anliegt (Panel-Körper, Registerkarte, Dialog, geteilter Bereich, Detailbereich), fügen Sie `with-inset="true"` hinzu:
{{{#!xml <form input="obj" with-inset="true">
<field attribute="name"/>
</form> }}}
Elemente ohne diese Option (<config-form>, <config-editor>) werden in <inset> eingeschlossen. Fügen Sie die Option nicht hinzu, wenn das Formular bereits innerhalb eines <inset> liegt, in einem Inset-Formular verschachtelt ist oder wenn sein einziger Inhalt eine bearbeitbare Tabelle ist, die den Bereich ausfüllen soll. Java-Code, der ein ` ReactFormLayoutControl ` (z. B. über `ReactFormBuilder`) für den Hauptteil eines Dialogs erstellt, umschließt dieses mit einem `ReactInsetControl`.