enhancement
major
minor
major
minor
major
#29625
TL-Ansichten: Ein Seitenlayout mit gewichteten Spalten (Hauptbereich 2/3, Seitenbereich 1/3), das bei einem schmalen Viewport auf eine Spalte umgebrochen wird; der geteilte Bereich behält seine Trennlinien bei und schneidet den Seitenbereich bei 400 px ab.
Problem
Die Ticket-Seite des Issue-Trackers tl-dev (ticket.view.xml) ist ein <split-panel orientation="vertical"> (Kopfbereich 25 %, Hauptbereich 75 %), dessen Hauptbereich ein <split-panel orientation="horizontal"> (Hauptspalte 65 %, Seitenspalte 35 %). Beide sind resizable="true". Dies ist die einzige Möglichkeit, die die Ansichtsebene bietet, um eine breite Hauptspalte neben einer schmalen Seitenspalte anzuordnen.
Gemessen bei einer Auflösung von 1600×900 (Engine-Snapshot-Build 37 vom 16.09.2026): Der obere Bereich ist 210 px hoch, während seine Formkarte 268 px misst, sodass die Zeilen „Status“ und „Typ“ der Kopfzeile unterhalb der Falz liegen und innerhalb des Bereichs gescrollt werden; die Trennleisten sind 4 px breite Balken mit Cursorn zum Anpassen der Zeilen- und Spaltengröße, die ein Leser eines Tickets aus keinem Grund verschieben müsste.
Gemessen bei 400×800 (ein Smartphone): Die beiden Spalten bleiben unverändert. Die horizontale Aufteilung des Hauptbereichs weist der Hauptspalte 320 px und der Seitenspalte 240 px zu, beginnend bei x = 324, sodass sich der rechte Rand der Seitenspalte bei 564 px befindet, 164 px außerhalb des Sichtbereichs; sein .tlPanel__content meldet clientWidth == scrollWidth == 240, sodass der abgeschnittene Teil nicht erreichbar ist und die Seite keinen horizontalen Bildlauf aufweist (documentElement.scrollWidth == clientWidth == 400). Die Beschriftungen sind auf „Klas…“, „Lösun“ und „Priori“ abgeschnitten. Der Kopfbereich ist 185 px hoch und zeigt die ID sowie eine Beschriftung seiner vier Felder an.
Was vorhanden ist und warum es nicht funktioniert:
- <grid min-column-width max-columns>: nur gleich breite Spalten, ein untergeordnetes Element kann weder über mehrere Spalten reichen noch ein Gewicht erhalten.
- <stack direction="row">: kein Zeilenumbruch und keine Gewichtung pro untergeordnetem Element; <panel width="…"> ist eine bevorzugte Breite, die niemals wächst, sodass ein 2/1-Paar die Zeile nicht ausfüllt und nicht umbricht.
- <adaptive-detail>: Ein Master-Detail-Layout mit einer festgelegten 32/68-Aufteilung und einer Drill-Down-Funktion auf der kompakten Seite, kein Seitenlayout.
- <dashboard>: Kacheln nehmen ihre Breite ein und das Raster wird auf eine Spalte umgebrochen, aber die Kacheln sind dafür gedacht, neu angeordnet zu werden, und haben (nach #29613) eine feste Zeilenhöhe, was für eine Seite falsch ist, deren Hauptspalte aus langem Inhalt besteht, der mit der Seite mitläuft.
Anforderung
Ein Seitenlayout mit gewichteten Spalten, das sich neu anordnet: Die Spalten teilen sich die Breite entsprechend ihrem Gewicht (Hauptspalte 2, Seitenspalte 1), während der Viewport sie nebeneinander anzeigt, und stapeln sich unterhalb eines Breakpoints in der Reihenfolge ihrer Deklaration – das Gegenstück zum <split-panel> für Leseseiten, bei denen kein Trennbalken gewünscht ist. Entweder ein `column-span ` / `weight` bei einem <grid> -Kind mit dem bestehenden „Fold-to-One-Column“-Verhalten des Rasters oder ein <columns> -Element mit <column weight="2"> -Kindern. Die Seite als Ganzes scrollt; eine Spalte ist so hoch wie ihr Inhalt.
Die daraus resultierende Änderung in der App: Die Ticketseite wird zu einem spaltenförmigen <stack> aus dem Header-Formular und einem solchen zweispaltigen Layout ohne geteilten Bereich, sodass der Header die Höhe einnimmt, die seine vier Felder benötigen, und die Seite auf einem Smartphone funktioniert.
Lösung
Ein <columns> -Element mit <column weight="…"> -Kindelementen:
<columns breakpoint="48rem" gap="default">
<column weight="2">
… Hauptinhalt …
</column>
<column>
… Seiteninhalt …
</column>
</columns>
- <column> (ColumnElement) ist ein Container: Seine untergeordneten Elemente stehen in der Spalte untereinander. „weight“ (eine positive Ganzzahl, standardmäßig 1) ist der Anteil der Spalte an der Zeile.
- <columns> (ColumnsElement) akzeptiert „breakpoint“ (eine CSS-Länge, standardmäßig 48rem, denselben Schwellenwert, den auch <adaptive-detail> verwendet) und „gap“ (compact / default / loose, wie bei <stack> und <grid>).
- Solange das Element selbst – also sein Container, nicht der Viewport, sodass sich ein verschachteltes Layout auf seine eigene Breite zusammenfaltet – mindestens so breit wie der Breakpoint ist, stehen die Spalten nebeneinander und teilen sich die Breite entsprechend „weight“ auf (2 und 1 ergeben 2/3 und 1/3). Darunter stehen sie in der Reihenfolge ihrer Deklaration untereinander, jeweils in voller Breite. Das Falten erfolgt rein über CSS (eine umbrüchende Flex-Zeile, deren Elemente flex: <weight> 1 calc((breakpoint - 100%) * 999) annehmen), ohne Messskript.
- Eine Spalte ist so hoch wie ihr Inhalt; das Element nimmt nicht am Füllvertrag teil, sodass eine daraus aufgebaute Seite als Ganzes gescrollt wird. Keine Trennstreifen.
Technisch gesehen: ReactColumnsControl (com.top_logic.layout.react, ein ReactLayoutControl, das die TLColumns-Komponente rendert) verwaltet die Gewichte, den Breakpoint und den Abstand; der Inhalt einer Spalte ist ein vertikales ReactStackControl. Dokumentiert in docs/faq/react-view-layer.md; eine Demoseite demo/columns-demo.view.xml in com.top_logic.demo.react.