Remote Compose Storybook Русский GitHub

Size · widthIn / heightIn / defaultMinSize

Bounds on the size the content asks for.

Size · widthIn / heightIn / defaultMinSize: 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

Controls how big something is: an exact size, a share of the available space, a minimum or maximum, or just as big as its content.

Good for

  • Fixed-size buttons
  • Full-width banners
  • Text boxes with a maximum width

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.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.defaultMinSize
import androidx.compose.remote.creation.compose.modifier.heightIn
import androidx.compose.remote.creation.compose.modifier.padding
import androidx.compose.remote.creation.compose.modifier.size
import androidx.compose.remote.creation.compose.modifier.widthIn
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 SizeConstraints(minWidth: Int, maxWidth: Int, minHeight: Int, text: String) {
    RemoteColumn(verticalArrangement = RemoteArrangement.spacedBy(12.rdp)) {
        // widthIn / heightIn bound the size the content asks for.
        RemoteText(
            text.rs,
            modifier =
                RemoteModifier.widthIn(min = minWidth.rdp, max = maxWidth.rdp)
                    .heightIn(min = minHeight.rdp)
                    .background(Color(0xFFFFE0B2).rc)
                    .padding(8.rdp),
        )
        // defaultMinSize applies only when nothing else constrains the size.
        RemoteBox(
            RemoteModifier.defaultMinSize(minWidth = minWidth.rdp, minHeight = minHeight.rdp)
                .background(Color(0xFFEF6C00).rc),
        )
    }
}

API

creation.compose.modifier.size

RemoteModifier size(RemoteModifier, RemoteDp size)
RemoteModifier size(RemoteModifier, RemoteDp width, RemoteDp height)

creation.compose.modifier.width

RemoteModifier width(RemoteModifier, RemoteDp width)
RemoteModifier width(RemoteModifier, RemoteFloat width)

creation.compose.modifier.height

RemoteModifier height(RemoteModifier, RemoteDp height)
RemoteModifier height(RemoteModifier, RemoteFloat height)

creation.compose.modifier.fillMaxWidth

RemoteModifier fillMaxWidth(RemoteModifier, optional RemoteFloat fraction)

creation.compose.modifier.fillMaxHeight

RemoteModifier fillMaxHeight(RemoteModifier, optional RemoteFloat fraction)

creation.compose.modifier.fillMaxSize

RemoteModifier fillMaxSize(RemoteModifier, optional RemoteFloat fraction)

creation.compose.modifier.widthIn

RemoteModifier widthIn(RemoteModifier, optional RemoteDp? min, optional RemoteDp? max)

creation.compose.modifier.heightIn

RemoteModifier heightIn(RemoteModifier, optional RemoteDp? min, optional RemoteDp? max)

creation.compose.modifier.defaultMinSize

RemoteModifier defaultMinSize(RemoteModifier, optional RemoteDp? minWidth, optional RemoteDp? minHeight)

creation.compose.modifier.wrapContentSize

RemoteModifier wrapContentSize(RemoteModifier)

Reference

Other stories of this component

More in Modifiers