sharedElement / sharedBounds
The same key in both branches.
Открыть живое интерактивное демо →
Меняйте параметры, смотрите удалённый документ, который получается, и разницу после каждого изменения.
Что это
Плавно переносит один и тот же элемент из одной раскладки в другую, чтобы пользователь видел, куда он делся.
Подходит для
- Превью, которое разворачивается в детальный экран
- Раскрытие компактной карточки
Код
Исходник примера с импортами androidx.compose.remote. CI компилирует каждый фрагмент кода на сайте против AndroidX.
import androidx.compose.remote.creation.compose.action.valueChangeAction
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.RemoteStateLayout
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.clickable
import androidx.compose.remote.creation.compose.modifier.sharedBounds
import androidx.compose.remote.creation.compose.modifier.sharedElement
import androidx.compose.remote.creation.compose.modifier.size
import androidx.compose.remote.creation.compose.state.MutableRemoteBoolean
import androidx.compose.remote.creation.compose.state.rc
import androidx.compose.remote.creation.compose.state.rdp
import androidx.compose.remote.creation.compose.state.remoteTween
import androidx.compose.remote.creation.compose.state.rs
import androidx.compose.runtime.Composable
import androidx.compose.runtime.remember
import androidx.compose.ui.graphics.Color
@Composable
@RemoteComposable
fun SharedElement(durationMillis: Int, bounds: Boolean) {
val expanded = remember { MutableRemoteBoolean(false) }
// The same key in both states: the player moves the element between them.
val shared =
if (bounds) RemoteModifier.sharedBounds(1, remoteTween(durationMillis))
else RemoteModifier.sharedElement(1, remoteTween(durationMillis))
RemoteStateLayout(expanded, RemoteModifier.clickable(valueChangeAction(expanded, !expanded))) {
isExpanded ->
if (isExpanded) {
RemoteBox(
RemoteModifier.size(300.rdp, 220.rdp),
contentAlignment = RemoteAlignment.BottomEnd,
) {
RemoteBox(
shared.size(200.rdp, 120.rdp).background(Color(0xFF1E88E5).rc),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("Tap to collapse".rs, color = Color.White.rc)
}
}
} else {
RemoteBox(
RemoteModifier.size(300.rdp, 220.rdp),
contentAlignment = RemoteAlignment.TopStart,
) {
RemoteBox(
shared.size(90.rdp).background(Color(0xFF1E88E5).rc),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("Tap".rs, color = Color.White.rc)
}
}
}
}
}
API
creation.compose.modifier.sharedElement
RemoteModifier sharedElement(RemoteModifier, int key, optional RemoteTweenSpec spec, optional RemoteEnterTransition enter, optional RemoteExitTransition exit)creation.compose.modifier.sharedBounds
RemoteModifier sharedBounds(RemoteModifier, int key, optional RemoteTweenSpec spec, optional RemoteEnterTransition enter, optional RemoteExitTransition exit)