Remote Compose Storybook Русский GitHub

rememberNamedRemote* · Mutable values

MutableRemoteFloat, String and Int changed by one combined action.

rememberNamedRemote* · Mutable values: the document drawn by the Remote Compose player
Open the live, interactive demo →

Change its controls, read the remote document it produces and the diff after every change.

What it is

Values with a name, such as a title or a colour, that the app showing the screen can change later without the server sending a new design.

Good for

  • Live scores and prices
  • Personalised greetings
  • Theme colours chosen by the app

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.action.combinedAction
import androidx.compose.remote.creation.compose.action.valueChangeAction
import androidx.compose.remote.creation.compose.layout.RemoteArrangement
import androidx.compose.remote.creation.compose.layout.RemoteBox
import androidx.compose.remote.creation.compose.layout.RemoteColumn
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.clickable
import androidx.compose.remote.creation.compose.modifier.clip
import androidx.compose.remote.creation.compose.modifier.padding
import androidx.compose.remote.creation.compose.modifier.size
import androidx.compose.remote.creation.compose.shapes.RemoteRoundedCornerShape
import androidx.compose.remote.creation.compose.state.MutableRemoteFloat
import androidx.compose.remote.creation.compose.state.MutableRemoteInt
import androidx.compose.remote.creation.compose.state.MutableRemoteString
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.ri
import androidx.compose.remote.creation.compose.state.rs
import androidx.compose.remote.creation.compose.state.toRemoteDp
import androidx.compose.runtime.Composable
import androidx.compose.runtime.remember
import androidx.compose.ui.graphics.Color

@Composable
@RemoteComposable
fun MutableValues(step: Float, label: String) {
    // Mutable remote values: the document holds them, actions change them.
    val progress = remember { MutableRemoteFloat(0f) }
    val title = remember { MutableRemoteString(label) }
    val taps = remember { MutableRemoteInt(0) }
    RemoteColumn(verticalArrangement = RemoteArrangement.spacedBy(10.rdp)) {
        RemoteBox(RemoteModifier.size(260.rdp, 16.rdp).background(Color(0xFFE0E0E0).rc)) {
            RemoteBox(
                RemoteModifier.size((progress * 260f.rf).toRemoteDp(), 16.rdp)
                    .background(Color(0xFF43A047).rc),
            )
        }
        RemoteText(title + " · taps: ".rs + taps.toRemoteString())
        RemoteBox(
            RemoteModifier.clip(RemoteRoundedCornerShape(12.rdp))
                .background(Color(0xFF1E88E5).rc)
                .clickable(
                    combinedAction(
                        valueChangeAction(progress, (progress + step.rf) % 1.0001f.rf),
                        valueChangeAction(title, "Tapped".rs),
                        valueChangeAction(taps, taps + 1.ri),
                    ),
                )
                .padding(12.rdp),
        ) {
            RemoteText("Advance".rs, color = Color.White.rc)
        }
    }
}

API

creation.compose.state.rememberNamedRemoteString

RemoteString rememberNamedRemoteString(String name, String defaultValue, optional RemoteState.Domain domain)

creation.compose.state.rememberNamedRemoteFloat

RemoteFloat rememberNamedRemoteFloat(String name, RemoteFloat defaultValue, optional RemoteState.Domain domain)

creation.compose.state.rememberNamedRemoteColor

RemoteColor rememberNamedRemoteColor(String name, RemoteColor defaultValue, optional RemoteState.Domain domain)

creation.compose.state.rememberNamedRemoteBoolean

RemoteBoolean rememberNamedRemoteBoolean(String name, boolean initialValue, optional RemoteState.Domain domain)

creation.compose.state.rememberNamedRemoteInt

RemoteInt rememberNamedRemoteInt(String name, int defaultValue, optional RemoteState.Domain domain)

creation.compose.state.rememberNamedRemoteEnum

inline <reified T extends java.lang.Enum<T>> RemoteEnum<T> rememberNamedRemoteEnum(String name, T initialValue, optional RemoteState.Domain domain)
<T extends java.lang.Enum<T>> RemoteEnum<T> rememberNamedRemoteEnum(String name, T initialValue, enums.EnumEntries<T> enumEntries, optional RemoteState.Domain domain)

Reference

Other stories of this component

More in State & expressions