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

Control

abstract class Control<T : Any>(val label: String?, val required: Boolean?, val dependencies: Map<String, ControlDependency<*>>?, val validationOptions: ValidationOptions? = null, val actions: List<ControlAction<T>>? = null, val hasStandardLayout: Boolean = true)

Abstrakcyjna klasa bazowa dla wszystkich kontrolek formularza.

Parameters

typ danych przechowywanych przez kontrolkę

Inheritors

PrimitiveNumberControl

Constructors

Control

internal constructor(label: String?, required: Boolean?, dependencies: Map<String, ControlDependency<*>>?, validationOptions: ValidationOptions? = null, actions: List<ControlAction<T>>? = null, hasStandardLayout: Boolean = true)

Properties

actions

private val actions: List<ControlAction<T>>?

dependencies

internal val dependencies: Map<String, ControlDependency<*>>?

errorManager

protected lateinit var errorManager: ErrorManager

formActionTrigger

protected lateinit var formActionTrigger: FormActionTrigger

formSchema

protected lateinit var formSchema: FormSchema

formState

protected lateinit var formState: FormState

hasStandardLayout

protected val hasStandardLayout: Boolean

hierarchyRole

internal var hierarchyRole: ControlHierarchyRole

Flaga określająca, rolę kontrolki w hierarchii.

label

internal val label: String?

required

internal val required: Boolean?

validationOptions

internal val validationOptions: ValidationOptions?

validator

protected open val validator: ControlValidator<T>

Validator odpowiedzialny za walidację tej kontrolki. Każdy typ kontrolki dostarcza własną implementację (np. StringValidator). Domyślnie pusta implementacja

Functions

convertToResult

protected open fun convertToResult(controlContext: ControlContext, state: ControlState<*>): ControlResultData

Konwertuje wewnętrzny stan kontrolki (ControlState) na wynik do zapisu (ControlResultData). Może być przesłonięta dla niestandardowych konwersji (np. w RepeatableControl).

copyInitToValue

internal open fun copyInitToValue(value: T): T

Tworzy głęboką kopię wartości początkowej dla bieżącej wartości. Kluczowe dla typów mutowalnych (np. List), aby zmiany w value nie wpływały na initValue.

Display

@Composable

protected abstract fun Display(controlContext: ControlContext, controlState: ControlState<T>, isRequired: Boolean)

Abstrakcyjna metoda renderowania specyficznego interfejsu kontrolki. Każdy konkretny typ kontrolki (np. StringControl) musi ją zaimplementować.

DisplayFieldErrors

@Composable

protected fun DisplayFieldErrors(controlContext: ControlContext)

Pomocnicza funkcja renderująca błędy walidacji dla tej kontrolki.

executeActions

protected fun executeActions(controlContext: ControlContext, newValue: T?, scope: CoroutineScope, payload: Any? = null)

Wykonuje zdefiniowane akcje dla tej kontrolki, zazwyczaj po zmianie wartości.

getResult

internal fun getResult(controlContext: ControlContext, state: ControlState<*>): ControlResultData

Pobiera wynik kontrolki (wartość bieżącą i początkową) do dalszego przetwarzania. Jeśli kontrolka jest niewidoczna, jej currentValue jest ustawiane na null.

initializeControlLifecycle

internal open fun initializeControlLifecycle(formState: FormState, formSchema: FormSchema, errorManager: ErrorManager, formActionTrigger: FormActionTrigger)

Ustawia referencje do komponentów formularza. Jest to drugi etap inicjalizacji kontrolki, wywoływany przez FormHandler. Daje dostęp do globalnego stanu, schemy i managera błędów. Dodatkowo umożliwia wykonanie dodatkowych kroków inicjalizacyjnych wymaganych przez określone kontrolki

registerChildrenInGlobalMap

internal open fun registerChildrenInGlobalMap(controlContext: ControlContext): Map<String, Control<*>>

Funkcja do rejestracji dzieci na globalnej mapie Zawiera referencje do kontrolek zdefiniowanych w kontrolce posiadającej własne

Render

@Composable

internal fun Render(controlContext: ControlContext, controlState: ControlState<*>)

Renderuje kontrolkę w interfejsie użytkownika. Ta metoda jest publicznym API dla FormScreen. Obsługuje logikę widoczności.

setInitValue

internal open fun setInitValue(controlContext: ControlContext, value: Any?): ControlState<T>

Ustawia początkową wartość kontrolki i tworzy jej stan (ControlState).

validateControl

internal fun validateControl(controlContext: ControlContext, state: ControlState<*>)

Uruchamia proces walidacji dla tej kontrolki przy użyciu przypisanego walidatora.