RemoteCollapsibleColumn / Row · Column priorities
Three 80dp children in a column whose height you control.
Open the live, interactive demo →
Change its controls, read the remote document it produces and the diff after every change.
What it is
A row or column that hides its least important items when space runs out, instead of squashing or cutting them.
Good for
- Widgets that must work at several sizes
- Toolbars that drop secondary actions on small screens
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.RemoteCollapsibleColumn
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.rs
import androidx.compose.runtime.Composable
import androidx.compose.ui.graphics.Color
@Composable
@RemoteComposable
fun CollapsibleColumnPriorities(height: Int) {
// Children that do not fit are dropped, lowest collapsiblePriority first.
RemoteCollapsibleColumn(
modifier =
RemoteModifier.width(240.rdp).height(height.rdp).background(Color(0xFFF1F3F4).rc),
) {
RemoteBox(
RemoteModifier.fillMaxWidth().height(80.rdp).background(Color(0xFFEF5350).rc),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("Always (no priority)".rs, color = Color.White.rc)
}
RemoteBox(
RemoteModifier.collapsiblePriority(1f)
.fillMaxWidth()
.height(80.rdp)
.background(Color(0xFF42A5F5).rc),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("Priority 1 (goes first)".rs, color = Color.White.rc)
}
RemoteBox(
RemoteModifier.collapsiblePriority(5f)
.fillMaxWidth()
.height(80.rdp)
.background(Color(0xFF66BB6A).rc),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("Priority 5".rs, color = Color.White.rc)
}
}
}
API
creation.compose.layout.RemoteCollapsibleColumn
void RemoteCollapsibleColumn(optional RemoteModifier modifier, optional RemoteArrangement.Vertical verticalArrangement, optional RemoteAlignment.Horizontal horizontalAlignment, RemoteCollapsibleColumnScope.() -> Unit content)creation.compose.layout.RemoteCollapsibleColumnScope
class RemoteCollapsibleColumnScope
RemoteCollapsibleColumnScope()
RemoteModifier collapsiblePriority(RemoteModifier, float priority)
RemoteModifier weight(RemoteModifier, RemoteFloat weight)
RemoteModifier weight(RemoteModifier, float weight)creation.compose.layout.RemoteCollapsibleRow
void RemoteCollapsibleRow(optional RemoteModifier modifier, optional RemoteArrangement.Horizontal horizontalArrangement, optional RemoteAlignment.Vertical verticalAlignment, RemoteCollapsibleRowScope.() -> Unit content)creation.compose.layout.RemoteCollapsibleRowScope
class RemoteCollapsibleRowScope
RemoteCollapsibleRowScope()
RemoteModifier collapsiblePriority(RemoteModifier, float priority)
RemoteModifier weight(RemoteModifier, RemoteFloat weight)
RemoteModifier weight(RemoteModifier, float weight)