form-engine/org.octavius.form.control.type.container/SectionControl

SectionControl

class SectionControl(val controls: List<String>, val collapsible: Boolean = true, val initiallyExpanded: Boolean = true, val columns: Int = 1, label: String, dependencies: Map<String, ControlDependency<*>>? = null) : Control<Unit>

Kontrolka do grupowania i organizacji innych kontrolek w sekcje.

Renderuje grupę kontrolek w karcie z nagłówkiem. Obsługuje składanie/rozwijanie sekcji, układanie kontrolek w kolumnach oraz zarządzanie relacjami rodzic-dziecko między kontrolkami. Umożliwia logiczne organizowanie formularza w tematyczne sekcje.

Constructors

SectionControl

constructor(controls: List<String>, collapsible: Boolean = true, initiallyExpanded: Boolean = true, columns: Int = 1, label: String, dependencies: Map<String, ControlDependency<*>>? = null)

Properties

actions

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

collapsible

val collapsible: Boolean

columns

val columns: Int

controls

val controls: List<String>

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.

initiallyExpanded

val initiallyExpanded: Boolean

label

internal val label: String?

required

internal val required: Boolean?

validationOptions

internal val validationOptions: ValidationOptions?

validator

protected open override val validator: ControlValidator<Unit>

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: Unit)

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 open override fun Display(controlContext: ControlContext, controlState: ControlState<Unit>, 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: Unit?, scope: CoroutineScope, payload: Any? = null)

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

executeInitActions

internal fun executeInitActions(controlContext: ControlContext, currentValue: Unit?, scope: CoroutineScope)

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 override 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<Unit>

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.