RemoteColumn · Weight fills the rest
A weighted child takes the height its fixed-size siblings leave.
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.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.fillMaxWidth
import androidx.compose.remote.creation.compose.modifier.height
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.rf
import androidx.compose.remote.creation.compose.state.rs
import androidx.compose.runtime.Composable
import androidx.compose.ui.graphics.Color
@Composable
@RemoteComposable
fun ColumnWeight(headerHeight: Int, footerHeight: Int) {
RemoteColumn(modifier = RemoteModifier.width(220.rdp).height(300.rdp)) {
RemoteBox(
RemoteModifier.fillMaxWidth().height(headerHeight.rdp).background(Color(0xFF5C6BC0).rc),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("Header".rs, color = Color.White.rc)
}
// weight(1f) takes whatever height the header and footer leave.
RemoteBox(
RemoteModifier.weight(1f.rf).fillMaxWidth().background(Color(0xFFE8EAF6).rc),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("weight(1f)".rs)
}
RemoteBox(
RemoteModifier.fillMaxWidth().height(footerHeight.rdp).background(Color(0xFF5C6BC0).rc),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("Footer".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