RemoteStateLayout · Int
Three branches selected by a RemoteInt.
Меняйте параметры, смотрите удалённый документ, который получается, и разницу после каждого изменения.
Что это
Держит несколько версий экрана — например, загрузка, содержимое и ошибка — и показывает нужную для текущего состояния, переключаясь на устройстве.
Подходит для
- Состояния загрузки, успеха и ошибки
- Пошаговые сценарии
- Свёрнутый и развёрнутый вид
Как это работает
Тип состояния существует только в вашем Kotlin, пока собирается документ. На устройство приходят целое число и сразу все варианты экрана.
MutableRemoteEnum(Screen.Loading)— этоMutableRemoteIntсordinal; список значений enum остаётся в Kotlin. Плеер не видит ниScreen, ни имён его значений.RemoteStateLayoutпри сборке вызывает вашу лямбду по разу на каждое состояние. Каждый вызов становится веткой операцииStateLayout, которая ссылается на это число; цвета, тексты и вашwhenв ветке уже посчитаны в константы (видно во вкладке «Документ»).valueChangeAction(screen, RemoteEnum(next))записывается как «присвой числу N».- На устройстве плеер показывает ветку для текущего значения; тап меняет число, и ветка переключается мгновенно, офлайн, без сервера и без Kotlin.
Итого: переключение мгновенное, но каждое состояние добавляет в документ ветку; логика в лямбде
выполняется один раз на сервере, а не при каждом тапе. С rememberNamedRemoteEnum("screen", …)
у числа появляется имя (USER:screen), и экран может переключать и приложение (вкладка
«Значения приложения»).
Код
Исходник примера с импортами 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.size
import androidx.compose.remote.creation.compose.state.MutableRemoteInt
import androidx.compose.remote.creation.compose.state.rc
import androidx.compose.remote.creation.compose.state.rdp
import androidx.compose.remote.creation.compose.state.ri
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 StateLayoutInt(initial: Int) {
val step = remember { MutableRemoteInt(initial) }
// Each listed state is one branch of the document; the player shows the current one.
RemoteStateLayout(
step,
0,
1,
2,
modifier = RemoteModifier.clickable(valueChangeAction(step, (step + 1.ri) % 3.ri)),
) { index ->
val color =
when (index) {
0 -> Color(0xFF1E88E5)
1 -> Color(0xFFFB8C00)
else -> Color(0xFF8E24AA)
}
RemoteBox(
RemoteModifier.size(220.rdp, 90.rdp).background(color.rc),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("Step $index of 3 — tap for next".rs, color = Color.White.rc)
}
}
}
API
creation.compose.layout.RemoteStateLayout
void RemoteStateLayout(RemoteBoolean currentState, optional RemoteModifier modifier, java.lang.Boolean.() -> Unit content)
<T extends java.lang.Enum<T>> void RemoteStateLayout(RemoteEnum<T> currentState, optional RemoteModifier modifier, T.() -> Unit content)
void RemoteStateLayout(RemoteInt currentState, int... states, optional RemoteModifier modifier, java.lang.Integer.() -> Unit content)creation.compose.state.MutableRemoteBoolean
class MutableRemoteBoolean extends RemoteBoolean implements MutableRemoteState<java.lang.Boolean>
Boolean? constantValueOrNull
MutableRemoteBoolean MutableRemoteBoolean(boolean initialValue)creation.compose.state.MutableRemoteInt
class MutableRemoteInt extends RemoteInt implements MutableRemoteState<java.lang.Integer>
MutableRemoteInt MutableRemoteInt(int initialValue)creation.compose.state.MutableRemoteEnum
class MutableRemoteEnum<T extends java.lang.Enum<T>> extends RemoteEnum<T> implements MutableRemoteState<T>
MutableRemoteEnum(MutableRemoteInt remoteInt, enums.EnumEntries<T> enumEntries)
MutableRemoteInt remoteInt
inline <reified T extends java.lang.Enum<T>> MutableRemoteEnum<T> MutableRemoteEnum(T initialValue)