Size · fillMax*
fillMaxWidth / fillMaxHeight with a fraction of the parent.
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.RemoteAlignment
import androidx.compose.remote.creation.compose.layout.RemoteBox
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.fillMaxHeight
import androidx.compose.remote.creation.compose.modifier.fillMaxWidth
import androidx.compose.remote.creation.compose.modifier.size
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 FillFractions(widthFraction: Float, heightFraction: Float) {
RemoteBox(RemoteModifier.size(300.rdp, 240.rdp).background(Color(0xFFF1F3F4).rc)) {
RemoteBox(
RemoteModifier.fillMaxWidth(widthFraction.rf)
.fillMaxHeight(heightFraction.rf)
.background(Color(0xFF7E57C2).rc),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("fillMax".rs, color = Color.White.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)