enhancement
major
minor
major
minor
major
#29487
React-Ansicht: „ <form> “ gibt weder die Spaltenanzahl noch die Position der Beschriftung preis, und es gibt kein „ <group> “-Element.
Wurde in 8.0.0-alpha7 beim Erstellen der React-Benutzeroberfläche der Consulting-Anwendung festgestellt (Consulting-Issue #94).
Zusammenfassung
Zwei miteinander zusammenhängende Lücken führen dazu, dass ein Formular in einer Ansicht nicht anpassbar ist:
- FormElement.Config verfügt über kein Attribut für die Spaltenanzahl oder die Position der Beschriftung, sodass jedes <form> in jeder Ansicht mit den React-Standardwerten maxColumns = 3 und labelPosition = „auto“ gerendert wird.
- TLFormGroup / ReactFormGroupControl ist in tl-layout-react vorhanden – Header, Rahmen (keiner/dezent/umrandet), einklappbar, fullLine –, aber tl-layout-view registriert kein @TagName dafür. Die Tag-Liste umfasst field, inset, grid und text. Ein View-Autor kann Felder überhaupt nicht gruppieren.
Auswirkung
Ein Formular in einem Bereich, der schmaler als 960px ist, erhält zwei Spalten mit Beschriftungen über den Feldern, da „auto“ erst ab einer Formularbreite von 960px auf seitliche Beschriftungen umschaltet. Das Ergebnis wirkt eher wie ein unregelmäßiger zweispaltiger Block aus übereinanderliegenden Beschriftungs-/Feldpaaren als wie ein Formular. In der Consulting-Anwendung betrifft dies jede Detailansicht (Kunde, Projekt, Stakeholder, Aufgabe, Dokument): Der Detailbereich nimmt 60 % des Fensters ein, was bei einem 1440px-Bildschirm etwa 840px entspricht, sodass der Schwellenwert nie erreicht wird. Es gibt keine Möglichkeit, festzulegen, dass hier „eine Spalte“ oder „Beschriftungen neben den Feldern“ angezeigt werden sollen, und es gibt keine Möglichkeit, „Name“, „Kontakt“ und „Adresse“ voneinander zu trennen.
Grundursache
- com.top_logic.layout.view.form.FormControl ist das TLFormLayout (super(context, initialObject, „TLFormLayout“)) und legt weder maxColumns noch labelPosition dafür fest.
- com.top_logic.layout.view.form.FormElement.Config deklariert keine entsprechende Eigenschaft, sodass auch über XML nichts festgelegt werden kann.
- Auf der Client-Seite berechnet die Komponente ihre Spalten als repeat(auto-fit, minmax(min(21rem, 100 %), 1fr)) – wobei 21rem dem Wert max(16, 64 / maxColumns) entspricht – und wählt Seitenbeschriftungen nur dann aus, wenn width / maxColumns >= 320px ist.
- com.top_logic.layout.react.control.form.ReactFormGroupControl und seine TLFormGroup-Komponente sind vollständig und werden intern verwendet, aber kein UIElement in tl-layout-view erstellt eine solche.
Anfrage
- „max-columns“ und „label-position“ in FormElement.Config, die an die bereits vorhandenen TLFormLayout -Eigenschaften weitergegeben werden.
- Ein <group> -Element in „tl-layout-view“, das „ReactFormGroupControl“ umschließt, mit den Eigenschaften, über die die Komponente bereits verfügt (label, border, collapsible, full-line), und untergeordneten Elementen wie bei jedem anderen Container.
Workaround
Überschreiben der framework-eigenen internen Klassennamen (.tlFormLayout, .tlFormField) über das Anwendungs-Stylesheet. Dies wirkt sich auf die Spaltenanzahl aus, nicht auf die Gruppierung, und führt bei jedem Engine-Upgrade zu Fehlern.
Lösung
Spaltenanzahl und Beschriftungsposition eines Formulars. Ein <form> akzeptiert dieselben zwei Layout-Attribute wie ein <fields> -Raster: max-columns (die maximale Anzahl an Spalten, in denen die Felder angeordnet werden, standardmäßig 3) und label-position (standardmäßig„auto “: Beschriftungen neben den Eingabefeldern, wenn die Spalte breit genug ist, darüber, wenn dies nicht der Fall ist; „side“ und „top“ legen die Position unabhängig von der Breite fest). Eine Position auf Feldebene wie „after“ oder „hidden“ wird mit einem Konfigurationsfehler abgelehnt. Beide Elemente teilen sich die Optionen über eine Konfigurationsschnittstelle (FormLayoutOptions), sodass sie nur einmal dokumentiert und validiert werden.
{{{#!xml <form input="selectedMilestone" max-columns="1" label-position="side">
<field attribute="name"/>
...
</form> }}}
Abschnitte eines Formulars: <group>. Ein neues Container-Element <group> (GroupElement) ordnet seinen Inhalt einem Abschnitt des umgebenden Formularrasters zu. Seine Attribute sind diejenigen, die der Abschnitt bereits bietet: ein <label>, das als Abschnittsüberschrift angezeigt wird, Rahmen (keiner, dezent oder umrandet; standardmäßig keiner ), einklappbar (ein Chevron in der Überschrift klappt den Abschnitt weg), eingeklappt (der Ausgangszustand eines einklappbaren Abschnitts) und „full-line“. Ein Abschnitt erstreckt sich standardmäßig über das gesamte Formular (full-line="true"); bei full-line="false" belegt er eine Spalte des Rasters und stapelt seinen Inhalt darin. Sein Inhalt besteht aus beliebigen View-Elementen – Feldern, Texten, Einblendungen, verschachtelten Gruppen – und er funktioniert sowohl innerhalb von <fields> als auch innerhalb von <form>, wobei es sich in beiden Fällen um dasselbe Raster handelt.
{{{#!xml <form input="model">
<group border="subtle" collapsible="true">
<label>
<en>Address</en>
<de>Adresse</de>
</label>
<field attribute="street"/>
<field attribute="city"/>
</group>
</form> }}}
Framework: Der Rahmen von `ReactFormGroupControl` ist im Java-Konstruktor und bei jedem Aufrufer eine typisierte Aufzählung (`ReactFormGroupControl.GroupBorder`) anstelle einer einfachen Zeichenkette. Der an den Client gesendete Wert bleibt unverändert. Im Konfigurationseditor übernahm der Abschnitt, der eine Sammlungseigenschaft enthält, bisher den Wert „default“, den keine Stylesheet-Regel kennt und der daher keinen Rahmen zeichnete; nun übernimmt er den dezenten Rahmen des gleichrangigen Abschnitts, der eine verschachtelte Konfiguration enthält.
Demo und Dokumentation: In tl-demo-react unterteilt der Dialog „Demo-Objekt bearbeiten“ auf der Seite „Attribute“ seine fünfzig Felder in acht zusammenklappbare Gruppen mit einem dezenten Rahmen (die Gruppe „Quellcode“ ist zunächst ausgeblendet), und das Meilenstein-Formular der responsiven Master-Detail-Demo ist einspaltig mit seitlichen Beschriftungen angelegt. Die FAQ unter docs/faq/react-view-layer.md beschreibt sowohl die Optionen von <form> als auch <group>.