RemoteRow · Arrangement & alignment
Change how the row spends its free space and aligns children of different heights.
Open the live, interactive demo →
Change its controls, read the remote document it produces and the diff after every change.
What it is
Places items side by side, left to right, and decides how leftover horizontal space is shared between them.
Good for
- An icon next to a label
- A toolbar of buttons
- Columns that share the width in a ratio
Code
The story's source with androidx.compose.remote imports. CI compiles every snippet on this site against AndroidX.
import androidx.compose.remote.creation.compose.layout.RemoteAlignment
import androidx.compose.remote.creation.compose.layout.RemoteArrangement
import androidx.compose.remote.creation.compose.layout.RemoteBox
import androidx.compose.remote.creation.compose.layout.RemoteComposable
import androidx.compose.remote.creation.compose.layout.RemoteRow
import androidx.compose.remote.creation.compose.layout.RemoteText
import androidx.compose.remote.creation.compose.modifier.RemoteModifier
import androidx.compose.remote.creation.compose.modifier.background
import androidx.compose.remote.creation.compose.modifier.fillMaxWidth
import androidx.compose.remote.creation.compose.modifier.height
import androidx.compose.remote.creation.compose.modifier.size
import androidx.compose.remote.creation.compose.state.rc
import androidx.compose.remote.creation.compose.state.rdp
import androidx.compose.remote.creation.compose.state.rs
import androidx.compose.runtime.Composable
import androidx.compose.ui.graphics.Color
@Composable
@RemoteComposable
fun RowArrangement(
horizontalArrangement: RemoteArrangement.Horizontal,
verticalAlignment: RemoteAlignment.Vertical,
itemCount: Int,
) {
RemoteRow(
modifier = RemoteModifier.fillMaxWidth().height(120.rdp).background(Color(0xFFF1F3F4).rc),
horizontalArrangement = horizontalArrangement,
verticalAlignment = verticalAlignment,
) {
for (i in 1..itemCount) {
RemoteBox(
modifier =
RemoteModifier.size(48.rdp, (24 + i * 14).rdp).background(Color(0xFF7E57C2).rc),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("$i".rs, color = Color.White.rc)
}
}
}
}
API
creation.compose.layout.RemoteRow
void RemoteRow(optional RemoteModifier modifier, optional RemoteArrangement.Horizontal horizontalArrangement, optional RemoteAlignment.Vertical verticalAlignment, RemoteRowScope.() -> Unit content)creation.compose.layout.RemoteRowScope
class RemoteRowScope
RemoteRowScope()
RemoteModifier weight(RemoteModifier, RemoteFloat weight)creation.compose.layout.RemoteArrangement
class RemoteArrangement
RemoteArrangement.HorizontalOrVertical spacedBy(RemoteDp space)
RemoteArrangement.Horizontal spacedBy(RemoteDp space, RemoteAlignment.Horizontal alignment)
RemoteArrangement.Vertical spacedBy(RemoteDp space, RemoteAlignment.Vertical alignment)
RemoteArrangement.HorizontalOrVertical spacedBy(RemoteFloat space)
RemoteArrangement.Horizontal spacedBy(RemoteFloat space, RemoteAlignment.Horizontal alignment)
RemoteArrangement.Vertical spacedBy(RemoteFloat space, RemoteAlignment.Vertical alignment)
RemoteArrangement.Vertical Bottom
RemoteArrangement.HorizontalOrVertical Center
RemoteArrangement.Horizontal End
RemoteArrangement.HorizontalOrVertical SpaceAround
RemoteArrangement.HorizontalOrVertical SpaceBetween
RemoteArrangement.HorizontalOrVertical SpaceEvenly
RemoteArrangement.Horizontal Start
RemoteArrangement.Vertical Top
RemoteArrangement INSTANCE