RemoteStateLayout · Enum
A branch per enum entry.
Меняйте параметры, смотрите удалённый документ, который получается, и разницу после каждого изменения.
Что это
Держит несколько версий экрана — например, загрузка, содержимое и ошибка — и показывает нужную для текущего состояния, переключаясь на устройстве.
Подходит для
- Состояния загрузки, успеха и ошибки
- Пошаговые сценарии
- Свёрнутый и развёрнутый вид
Как это работает
Тип состояния существует только в вашем 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.MutableRemoteEnum
import androidx.compose.remote.creation.compose.state.RemoteEnum
import androidx.compose.remote.creation.compose.state.rc
import androidx.compose.remote.creation.compose.state.rdp
import androidx.compose.remote.creation.compose.state.rs
import androidx.compose.runtime.Composable
import androidx.compose.runtime.remember
import androidx.compose.ui.graphics.Color
enum class Screen {
Loading,
Content,
Error,
}
@Composable
@RemoteComposable
fun StateLayoutEnum(initial: Screen) {
val screen = remember { MutableRemoteEnum(initial) }
RemoteStateLayout(screen) { current ->
val next = Screen.entries[(current.ordinal + 1) % Screen.entries.size]
RemoteBox(
RemoteModifier.size(240.rdp, 90.rdp)
.background(
when (current) {
Screen.Loading -> Color(0xFF757575)
Screen.Content -> Color(0xFF43A047)
Screen.Error -> Color(0xFFE53935)
}.rc,
)
.clickable(valueChangeAction(screen, RemoteEnum(next))),
contentAlignment = RemoteAlignment.Center,
) {
RemoteText("${current.name} — tap for ${next.name}".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)