Compose에서 UI 요소는 호출될 때 UI 요소를 내보내는 구성 가능한 함수로 표시됩니다. 그런 다음 화면에 렌더링되는 UI 트리에 추가됩니다. 각 UI 요소에는 하나의 상위 요소와 여러 개의 하위 요소가 있을 수 있습니다. 또한 각 요소는 (x, y) 위치로 지정된 상위 요소 내에 배치되며 width
및 height
로 크기가 지정됩니다.
상위 요소는 하위 요소의 제약 조건을 정의합니다. 이러한 제약 조건 내에서 요소의 크기를 정의해야 합니다. 제약 조건은 요소의 최소/최대 width
및 height
를 제한합니다. 요소에 하위 요소가 있으면 각 하위 요소를 측정하여 요소의 크기를 결정할 수 있습니다. 요소가 자체 크기를 결정하고 보고하면 맞춤 레이아웃 만들기에 자세히 설명된 대로 그 요소를 기준으로 하위 요소를 배치하는 방법을 정의할 수 있습니다.
UI 트리에 각 노드를 배치하는 작업은 3단계로 진행됩니다. 각 노드는 다음을 실행해야 합니다.
- 모든 하위 요소 측정
- 자체 크기 결정
- 하위 요소 배치
범위 사용은 하위 요소를 측정하고 배치할 수 있는 시점을 정의합니다.
레이아웃 측정은 측정 및 레이아웃 패스 중에만 실행할 수 있고 하위 요소는 레이아웃 패스 중에만 그리고 미리 측정된 후에만 배치할 수 있습니다. MeasureScope
, PlacementScope
와 같은 Compose 범위로 인해 컴파일 시간에 적용됩니다.
레이아웃 수정자 사용
layout
수정자를 사용하여 요소가 측정되고 배치되는 방식을 수정할 수 있습니다. Layout
은 람다입니다. 매개변수에는 측정할 수 있는 요소(measurable
로 전달됨) 및 이 컴포저블의 수신된 제약 조건(constraints
로 전달됨)이 포함됩니다. 맞춤 레이아웃 수정자는 다음과 같습니다.
fun Modifier.customLayoutModifier() = layout { measurable, constraints -> // ... }
화면에 Text
를 표시하고 텍스트 첫 줄의 상단에서 기준선까지의 거리를 제어해 보겠습니다. 이는 정확히 paddingFromBaseline
수정자의 기능이며 여기에 이 기능을 예로 구현합니다.
그렇게 하려면 layout
수정자를 사용하여 컴포저블을 화면에 수동으로 배치해야 합니다. 원하는 동작은 다음과 같으며 여기서 Text
상단 패딩은 24.dp
로 설정됩니다.
다음은 해당 간격을 생성하는 코드입니다.
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) } }
이 코드에서 이루어지는 작업은 다음과 같습니다.
measurable
람다 매개변수에서measurable.measure(constraints)
를 호출하여 측정 가능한 매개변수로 표시되는Text
를 측정합니다.layout(width, height)
메서드를 호출하여 컴포저블의 크기를 지정합니다. 이 메서드는 래핑된 요소 배치에 사용되는 람다도 제공합니다. 이 경우 크기는 마지막 기준선과 추가된 상단 패딩 사이의 높이입니다.placeable.place(x, y)
를 호출하여 화면에 래핑된 요소를 배치합니다. 래핑된 요소를 배치하지 않으면 래핑된 요소가 표시되지 않습니다.y
위치는 텍스트의 첫 번째 기준선 위치인 상단 패딩에 상응합니다.
예상대로 작동하는지 확인하려면 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)) } }
맞춤 레이아웃 만들기
layout
수정자는 호출하는 컴포저블만 변경합니다. 여러 컴포저블을 측정하고 배치하려면 Layout
컴포저블을 대신 사용하세요. 이 컴포저블을 사용하면 하위 요소를 수동으로 측정하고 배치할 수 있습니다. Column
및 Row
와 같은 모든 상위 수준 레이아웃은 Layout
컴포저블을 사용하여 빌드됩니다.
Column
의 매우 기본적인 버전을 빌드해 보겠습니다. 대부분의 맞춤 레이아웃은 다음 패턴을 따릅니다.
@Composable fun MyBasicColumn( modifier: Modifier = Modifier, content: @Composable () -> Unit ) { Layout( modifier = modifier, content = content ) { measurables, constraints -> // measure and position children given constraints logic here // ... } }
layout
수정자와 마찬가지로 measurables
는 측정해야 하는 하위 요소 목록이며 constraints
는 상위 요소의 제약 조건입니다.
앞서와 동일한 로직에 따라 MyBasicColumn
을 다음과 같이 구현할 수 있습니다.
@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 } } } }
하위 컴포저블은 (minHeight
제약 조건 없이) Layout
제약 조건에 의해 제한되며 이전 컴포저블의 yPosition
을 기반으로 배치됩니다.
맞춤 컴포저블을 사용하는 방법은 다음과 같습니다.
@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!") } }
레이아웃 방향
LocalLayoutDirection
컴포지션 로컬을 변경하여 컴포저블의 레이아웃 방향을 변경합니다.
화면에 컴포저블을 수동으로 배치하는 경우 LayoutDirection
은 layout
수정자 또는 Layout
컴포저블의 LayoutScope
에 포함되어 있습니다.
layoutDirection
을 사용할 때는 place
를 사용하여 컴포저블을 배치합니다. placeRelative
메서드와 달리 place
는 레이아웃 방향(왼쪽에서 오른쪽 또는 오른쪽에서 왼쪽)에 따라 변경되지 않습니다.
맞춤 레이아웃 실제 사례
Compose의 기본 레이아웃에서 레이아웃과 수정자에 관해 자세히 알아보고 맞춤 레이아웃을 만드는 Compose 샘플에서 실제 맞춤 레이아웃을 확인하세요.
자세히 알아보기
Compose의 맞춤 레이아웃에 관한 자세한 내용은 다음 추가 리소스를 참고하세요.
동영상
추천 서비스
- 참고: JavaScript가 사용 중지되어 있으면 링크 텍스트가 표시됩니다.
- Compose 레이아웃의 내장 기능 측정
- Compose의 그래픽
- Compose 수정자