Padding, offset, zIndex · padding
Per-side, horizontal/vertical and RemotePaddingValues padding.
Open the live, interactive demo →
Change its controls, read the remote document it produces and the diff after every change.
What it is
Inner spacing around content, nudging an element away from its position, and choosing which of two overlapping elements is on top.
Good for
- Comfortable tap areas
- Overlapping avatars
- Bringing a selected card to the front
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.RemotePaddingValues
import androidx.compose.remote.creation.compose.modifier.RemoteModifier
import androidx.compose.remote.creation.compose.modifier.background
import androidx.compose.remote.creation.compose.modifier.padding
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.runtime.Composable
import androidx.compose.ui.graphics.Color
@Composable
@RemoteComposable
fun PaddingVariants(start: Int, top: Int, end: Int, bottom: Int) {
RemoteColumn(verticalArrangement = RemoteArrangement.spacedBy(10.rdp)) {
RemoteBox(
RemoteModifier.background(Color(0xFFBBDEFB).rc)
.padding(start = start.rdp, top = top.rdp, end = end.rdp, bottom = bottom.rdp),
) {
RemoteBox(RemoteModifier.size(120.rdp, 40.rdp).background(Color(0xFF1E88E5).rc))
}
RemoteBox(
RemoteModifier.background(Color(0xFFC8E6C9).rc)
.padding(horizontal = start.rdp, vertical = top.rdp),
) {
RemoteBox(RemoteModifier.size(120.rdp, 40.rdp).background(Color(0xFF43A047).rc))
}
RemoteBox(
RemoteModifier.background(Color(0xFFFFE0B2).rc).padding(RemotePaddingValues(start.rdp)),
) {
RemoteBox(RemoteModifier.size(120.rdp, 40.rdp).background(Color(0xFFFB8C00).rc))
}
}
}
API
creation.compose.modifier.padding
RemoteModifier padding(RemoteModifier, RemotePaddingValues paddingValues)
RemoteModifier padding(RemoteModifier, RemoteDp all)
RemoteModifier padding(RemoteModifier, optional RemoteDp horizontal, optional RemoteDp vertical)
RemoteModifier padding(RemoteModifier, optional RemoteDp start, optional RemoteDp top, optional RemoteDp end, optional RemoteDp bottom)
RemoteModifier padding(RemoteModifier, RemoteFloat all)
RemoteModifier padding(RemoteModifier, optional RemoteFloat horizontal, optional RemoteFloat vertical)
RemoteModifier padding(RemoteModifier, optional RemoteFloat start, optional RemoteFloat top, optional RemoteFloat end, optional RemoteFloat bottom)creation.compose.layout.RemotePaddingValues
class RemotePaddingValues
RemotePaddingValues()
RemotePaddingValues(RemoteDp all)
RemotePaddingValues(optional RemoteDp horizontal, optional RemoteDp vertical)
RemotePaddingValues(optional RemoteDp leftPadding, optional RemoteDp topPadding, optional RemoteDp rightPadding, optional RemoteDp bottomPadding)
RemoteDp bottomPadding
RemoteDp leftPadding
RemoteDp rightPadding
RemoteDp topPaddingcreation.compose.modifier.offset
RemoteModifier offset(RemoteModifier, optional RemoteDp x, optional RemoteDp y)creation.compose.modifier.zIndex
RemoteModifier zIndex(RemoteModifier, RemoteFloat zIndex)