Size · widthIn / heightIn / defaultMinSize
Bounds on the size the content asks for.
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)