Remote Compose Storybook English GitHub

RemoteStateLayout · Int

Three branches selected by a RemoteInt.

RemoteStateLayout · Int: документ, нарисованный плеером Remote Compose
Открыть живое интерактивное демо →

Меняйте параметры, смотрите удалённый документ, который получается, и разницу после каждого изменения.

Что это

Держит несколько версий экрана — например, загрузка, содержимое и ошибка — и показывает нужную для текущего состояния, переключаясь на устройстве.

Подходит для

  • Состояния загрузки, успеха и ошибки
  • Пошаговые сценарии
  • Свёрнутый и развёрнутый вид

Как это работает

Тип состояния существует только в вашем Kotlin, пока собирается документ. На устройство приходят целое число и сразу все варианты экрана.

  1. MutableRemoteEnum(Screen.Loading) — это MutableRemoteInt с ordinal; список значений enum остаётся в Kotlin. Плеер не видит ни Screen, ни имён его значений.
  2. RemoteStateLayout при сборке вызывает вашу лямбду по разу на каждое состояние. Каждый вызов становится веткой операции StateLayout, которая ссылается на это число; цвета, тексты и ваш when в ветке уже посчитаны в константы (видно во вкладке «Документ»).
  3. valueChangeAction(screen, RemoteEnum(next)) записывается как «присвой числу N».
  4. На устройстве плеер показывает ветку для текущего значения; тап меняет число, и ветка переключается мгновенно, офлайн, без сервера и без 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)

Справочник

Другие примеры этого компонента

Ещё в разделе «Состояние и выражения»