form-engine/org.octavius.form.component/FormState

FormState

Reaktywne zarządzanie stanem wszystkich kontrolek formularza.

FormState przechowuje i zarządza stanami wszystkich kontrolek w formularzu, wykorzystując Compose State API dla automatycznej rekomposycji UI przy zmianach.

Główne funkcje:

Przechowywanie reaktywnych stanów kontrolek (MutableState)
Automatyczne wyzwalanie rekomposycji przy zmianach
Zarządzanie hierarchicznymi nazwami kontrolek (np. dla RepeatableControl)
Zbieranie danych z wszystkich kontrolek do przetworzenia

Stany kontrolek są indeksowane pełną ścieżką (np. "publicationsuuid.title"), co umożliwia obsługę złożonych, zagnieżdżonych struktur.

Constructors

FormState

constructor()

Properties

_controlStates

private val _controlStates: SnapshotStateMap<String, ControlState<*>>

Stan kontrolek formularza - reactive map która automatycznie triggeruje recomposition

actionTriggered

val actionTriggered: MutableState<Boolean>

Flaga wysyłania formularza (triggerAction). True podczas wykonywania akcji (np. zapis, usunięcie).

isLoading

val isLoading: MutableState<Boolean>

Flaga ładowania danych formularza (initData). True podczas początkowego pobierania danych z bazy.

Functions

collectFormData

internal fun collectFormData(schema: FormSchema): FormResultData

Zbiera i przetwarza dane ze wszystkich kontrolek formularza.

getAllStates

fun getAllStates(): Map<String, ControlState<*>>

Funkcja zwraca stany wszystkich kontrolek formularza

getControlState

fun getControlState(name: String): ControlState<*>?

Funkcja zwraca stan kontrolki o danej nazwie

initializeStates

internal fun initializeStates(schema: FormSchema, initValues: Map<String, Any?>)

Inicjalizuje stany wszystkich kontrolek na podstawie wartości początkowych.

removeControlState

internal fun removeControlState(name: String)

Funkcja usuwa stan kontrolki o danej nazwie Automatycznie triggeruje recomposition dzięki mutableStateMapOf

removeControlStatesWithPrefix

internal fun removeControlStatesWithPrefix(prefix: String)

Funkcja usuwa wszystkie stany kontrolek zaczynające się od danego prefiksu Automatycznie triggeruje recomposition dzięki mutableStateMapOf

setControlState

internal fun setControlState(name: String, state: ControlState<*>)

Funkcja ustawia stan kontrolki o danej nazwie (może być hierarchiczna) Automatycznie triggeruje recomposition dzięki mutableStateMapOf