In Compose werden UI-Elemente durch zusammensetzbare Funktionen dargestellt, die beim Aufrufen ein UI-Element ausgeben, das dann einem UI-Baum hinzugefügt wird, der auf dem Bildschirm gerendert wird. Jedes UI-Element hat ein übergeordnetes Element und möglicherweise viele untergeordnete Elemente. Jedes Element befindet sich auch in seinem übergeordneten Element, angegeben als (x, y)-Position und Größe, angegeben als width
und height
.
Übergeordnete Elemente definieren die Einschränkungen für ihre untergeordneten Elemente. Ein Element wird gebeten,
um die Größe
innerhalb dieser Einschränkungen zu definieren. Einschränkungen schränken die Mindest- und
Maximal width
und height
eines Elements. Hat ein Element untergeordnete Elemente, kann es
kann jedes untergeordnete Element messen, um seine Größe zu bestimmen. Sobald ein Element bestimmt,
und meldet ihre eigene Größe, kann sie festlegen, wie ihr untergeordnete
-Elemente relativ zu sich selbst, wie unter Benutzerdefinierte
Layouts
Die Anordnung der einzelnen Knoten im UI-Baum erfolgt in drei Schritten. Jeder Knoten muss:
- Untergeordnete Elemente messen
- Größe selbst festlegen
- Untergeordnete Elemente platzieren
Damit legen Sie fest, wann Sie Ihre Kinder messen und platzieren dürfen.
Das Messen eines Layouts kann nur während der Messung und des Layout-Durchlaufs erfolgen.
und ein untergeordnetes Element kann nur während des Layout-Passes platziert werden (und erst nachdem es
gemessen). Aufgrund von Compose-Bereichen wie
MeasureScope
,
und PlacementScope
,
bei der Kompilierung erzwungen.
Layout-Modifikator verwenden
Mit dem layout
-Modifikator können Sie ändern, wie ein Element gemessen und platziert wird.
aus. Layout
ist ein Lambda; seine Parameter umfassen das Element, das Sie messen können, übergeben als measurable
, und die eingehenden Einschränkungen dieses Composeables, übergeben als constraints
. Ein benutzerdefinierter Layout-Modifikator kann so aussehen:
fun Modifier.customLayoutModifier() = layout { measurable, constraints -> // ... }
Zeigen wir ein Text
auf dem Bildschirm an und steuern den Abstand von der Oberkante zur Grundlinie der ersten Textzeile. Genau das ist der
Der paddingFromBaseline
-Modifikator wird hier als Beispiel implementiert.
Verwenden Sie dazu den layout
-Modifikator, um die zusammensetzbare Funktion manuell im
Bildschirm. Hier ist das gewünschte Verhalten, wenn das obere Text
-Abstand 24.dp
festgelegt ist:
Hier ist der Code zum Erstellen des Abstands:
fun Modifier.firstBaselineToTop( firstBaselineToTop: Dp ) = layout { measurable, constraints -> // Measure the composable val placeable = measurable.measure(constraints) // Check the composable has a first baseline check(placeable[FirstBaseline] != AlignmentLine.Unspecified) val firstBaseline = placeable[FirstBaseline] // Height of the composable with padding - first baseline val placeableY = firstBaselineToTop.roundToPx() - firstBaseline val height = placeable.height + placeableY layout(placeable.width, height) { // Where the composable gets placed placeable.placeRelative(0, placeableY) } }
Hier ist, was in diesem Code passiert:
- Im Lambda-Parameter
measurable
messen Sie dieText
, die durch den messbaren Parameter durch Aufrufen vonmeasurable.measure(constraints)
. - Sie geben die Größe des Composeables an, indem Sie die Methode
layout(width, height)
aufrufen. Dadurch wird auch ein Lambda-Ausdruck zurückgegeben, der zum Platzieren der umhüllten Elemente verwendet wird. In diesem Fall ist es die Höhe zwischen der letzten Grundlinie und dem hinzugefügten oberen Abstand. - Sie positionieren die umgebrochenen Elemente auf dem Bildschirm, indem Sie
placeable.place(x, y)
aufrufen. Wenn die umschlossenen Elemente nicht platziert werden, werden sie nicht sichtbar sind. Diey
-Position entspricht dem oberen Abstand, also der Position der ersten Textgrundlinie.
Um zu prüfen, ob das wie erwartet funktioniert, verwenden Sie diesen Modifikator in einem Text
:
@Preview @Composable fun TextWithPaddingToBaselinePreview() { MyApplicationTheme { Text("Hi there!", Modifier.firstBaselineToTop(32.dp)) } } @Preview @Composable fun TextWithNormalPaddingPreview() { MyApplicationTheme { Text("Hi there!", Modifier.padding(top = 32.dp)) } }
Benutzerdefinierte Layouts erstellen
Der Modifizierer layout
ändert nur das Anruf-Composeable. Zum Messen und Layout
mehreren zusammensetzbaren Funktionen verwenden, verwenden Sie stattdessen die zusammensetzbare Funktion Layout
. Diese zusammensetzbare Funktion
können Sie Kinder manuell
messen und anordnen. Alle übergeordneten Layouts
Column
und Row
werden mit der zusammensetzbaren Funktion Layout
erstellt.
Erstellen wir eine sehr einfache Version von Column
. Die meisten benutzerdefinierten Layouts folgen diesem Muster:
@Composable fun MyBasicColumn( modifier: Modifier = Modifier, content: @Composable () -> Unit ) { Layout( modifier = modifier, content = content ) { measurables, constraints -> // measure and position children given constraints logic here // ... } }
Ähnlich wie beim layout
-Modifikator ist measurables
die Liste der untergeordneten Elemente, die
müssen gemessen werden und constraints
sind die Einschränkungen des übergeordneten Elements.
Gemäß der gleichen Logik wie zuvor kann MyBasicColumn
so implementiert werden:
@Composable fun MyBasicColumn( modifier: Modifier = Modifier, content: @Composable () -> Unit ) { Layout( modifier = modifier, content = content ) { measurables, constraints -> // Don't constrain child views further, measure them with given constraints // List of measured children val placeables = measurables.map { measurable -> // Measure each children measurable.measure(constraints) } // Set the size of the layout as big as it can layout(constraints.maxWidth, constraints.maxHeight) { // Track the y co-ord we have placed children up to var yPosition = 0 // Place children in the parent layout placeables.forEach { placeable -> // Position item on the screen placeable.placeRelative(x = 0, y = yPosition) // Record the y co-ord placed up to yPosition += placeable.height } } } }
Die untergeordneten Composeables sind durch die Layout
-Einschränkungen (ohne die minHeight
-Einschränkungen) eingeschränkt und werden basierend auf der yPosition
des vorherigen Composeables platziert.
So wird dieses benutzerdefinierte Composed-Element verwendet:
@Composable fun CallingComposable(modifier: Modifier = Modifier) { MyBasicColumn(modifier.padding(8.dp)) { Text("MyBasicColumn") Text("places items") Text("vertically.") Text("We've done it by hand!") } }
Layout-Richtung
Ändern Sie die Layoutrichtung eines Composeables, indem Sie die lokale LocalLayoutDirection
-Komposition ändern.
Wenn Sie zusammensetzbare Funktionen manuell auf dem Bildschirm platzieren, wird der LayoutDirection
Teil des LayoutScope
des layout
-Modifikators oder der zusammensetzbaren Layout
-Funktion.
Wenn du layoutDirection
verwendest, platziere die Elemente mit place
. Im Gegensatz zur Methode placeRelative
ändert sich place
nicht je nach Layoutrichtung (links nach rechts oder rechts nach links).
Benutzerdefinierte Layouts in der Praxis
Weitere Informationen zu Layouts und Modifikatoren finden Sie unter Grundlegende Layouts in Compose. Beispiele für benutzerdefinierte Layouts finden Sie unter Compose-Beispiele zum Erstellen benutzerdefinierter Layouts.
Weitere Informationen
Weitere Informationen zu benutzerdefinierten Layouts in Compose finden Sie in den folgenden zusätzlichen Ressourcen.
Videos
Empfehlungen für dich
- Hinweis: Der Linktext wird angezeigt, wenn JavaScript deaktiviert ist.
- Intrinsische Messungen in „Layouts erstellen“
- Grafiken in Compose
- Modifizierer erstellen