Padding, offset, zIndex · offset & zIndex
Move B over A, then flip which one is on top.
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.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.offset
import androidx.compose.remote.creation.compose.modifier.size
import androidx.compose.remote.creation.compose.modifier.zIndex
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.remote.creation.compose.state.rsp
import androidx.compose.runtime.Composable
import androidx.compose.ui.graphics.Color
@Composable
@RemoteComposable
fun OffsetAndZIndex(x: Int, y: Int, frontOnTop: Boolean) {
RemoteBox(RemoteModifier.size(260.rdp, 200.rdp)) {
RemoteBox(
RemoteModifier.zIndex(if (frontOnTop) 1f.rf else 0f.rf)
.size(120.rdp)
.background(Color(0xFFE53935).rc),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("A".rs, color = Color.White.rc, fontSize = 24.rsp)
}
// offset moves the drawing without changing the layout; zIndex orders siblings.
RemoteBox(
RemoteModifier.offset(x.rdp, y.rdp)
.zIndex(if (frontOnTop) 0f.rf else 1f.rf)
.size(120.rdp)
.background(Color(0xFF1E88E5).rc),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("B".rs, color = Color.White.rc, fontSize = 24.rsp)
}
}
}
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)