form-engine/org.octavius.form.control.base/ControlState

ControlState

data class ControlState<T>(val value: MutableState<T?> = mutableStateOf(null), val initValue: MutableState<T?> = mutableStateOf(null), val displayText: MutableState<String?> = mutableStateOf(null), val labelOverride: MutableState<String?> = mutableStateOf(null))

Reaktywny stan pojedynczej kontrolki formularza.

Przechowuje wszystkie informacje o stanie kontrolki potrzebne do renderowania, walidacji i śledzenia zmian, wykorzystując Compose State API dla automatycznej rekomposycji.

Parameters

value

Bieżąca wartość kontrolki (edytowana przez użytkownika) - MutableState.

initValue

Pierwotna wartość załadowana z bazy lub ustawiona domyślnie - MutableState.

displayText

Tekst pokazywany użytkownikowi, gdy nie da się go wyprowadzić z value przy każdym renderowaniu: bufor edycyjny pola liczbowego (1. nie jest jeszcze liczbą) albo etykieta wybranej pozycji dropdowna (wymaga zapytania). null znaczy "nieustalony" - kontrolka wypełni go sama, synchronicznie albo zapytaniem. Dlatego updateControl z zewnątrz zeruje to pole: zapisanie wartości unieważnia tekst, a samo zerowanie jest sygnałem do przeliczenia.

labelOverride

Etykieta nadpisana z akcji, zamiast tej ze schematu.

Type Parameters

Typ danych przechowywanych przez kontrolkę.

Constructors

ControlState

constructor(value: MutableState<T?> = mutableStateOf(null), initValue: MutableState<T?> = mutableStateOf(null), displayText: MutableState<String?> = mutableStateOf(null), labelOverride: MutableState<String?> = mutableStateOf(null))

Properties

displayText

val displayText: MutableState<String?>

initValue

val initValue: MutableState<T?>

labelOverride

val labelOverride: MutableState<String?>

value

val value: MutableState<T?>