Remote Compose Storybook Русский GitHub

RemoteCollapsibleColumn / Row · Column priorities

Three 80dp children in a column whose height you control.

RemoteCollapsibleColumn / Row · Column priorities: 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

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)

Reference

Other stories of this component

More in Layout