Remote Compose Storybook Русский GitHub

RemoteColumn · Arrangement & alignment

Distribute free height and align children of different widths.

RemoteColumn · Arrangement & alignment: the document drawn by the Remote Compose player
Open the live, interactive demo →

Change its controls, read the remote document it produces and the diff after every change.

What it is

Stacks items top to bottom and decides how leftover vertical space is shared between them.

Good for

  • A card with a title, body and footer
  • A list of settings
  • A header and footer with content filling the middle

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.RemoteColumn
import androidx.compose.remote.creation.compose.layout.RemoteComposable
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.height
import androidx.compose.remote.creation.compose.modifier.size
import androidx.compose.remote.creation.compose.modifier.width
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 ColumnArrangement(
    verticalArrangement: RemoteArrangement.Vertical,
    horizontalAlignment: RemoteAlignment.Horizontal,
    itemCount: Int,
) {
    RemoteColumn(
        modifier = RemoteModifier.width(220.rdp).height(300.rdp).background(Color(0xFFF1F3F4).rc),
        verticalArrangement = verticalArrangement,
        horizontalAlignment = horizontalAlignment,
    ) {
        for (i in 1..itemCount) {
            RemoteBox(
                modifier =
                    RemoteModifier.size((40 + i * 24).rdp, 40.rdp).background(Color(0xFF26A69A).rc),
                contentAlignment = RemoteAlignment.Center,
            ) {
                RemoteText("Item $i".rs, color = Color.White.rc)
            }
        }
    }
}

API

creation.compose.layout.RemoteColumn

void RemoteColumn(optional RemoteModifier modifier, optional RemoteArrangement.Vertical verticalArrangement, optional RemoteAlignment.Horizontal horizontalAlignment, RemoteColumnScope.() -> Unit content)

creation.compose.layout.RemoteColumnScope

class RemoteColumnScope
  RemoteColumnScope()
  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

Reference

Other stories of this component

More in Layout