core/de.peekandpoke.kraft.addons.forms/GenericFormField

GenericFormField

open class GenericFormField<T, O : FieldOptions<T>, P : GenericFormField.Props<T, O>>(ctx: Ctx) : Component , FormField<T>

Constructors

GenericFormField

fun > GenericFormField(ctx: Ctx)

Types

DefaultProps

data class DefaultProps<T, O : FieldOptions<T>>(val value: T, val onChange: (T) -> Unit, val options: O) : GenericFormField.Props<T, O>

Props

interface Props<T, O : FieldOptions<T>>

Functions

createRef

fun <C : Component<*>> createRef(): ComponentRef.Tracker<C>

focus

fun focus(cssSelector: String)

invoke

operator fun <T> Stream<T>.invoke(handler: (T) -> Unit): () -> Unit

Subscribes to a Stream.

render

open override fun VDom.render()

Every component needs to implement this method

renderLabel

fun FlowContent.renderLabel(onClick: (evt: MouseEvent) -> Unit? = null)

fun FlowContent.renderLabel(focusCssSelector: String? = null)

reset

open override fun reset()

Resets the form field.

setValue

fun setValue(value: T)

shouldRedraw

open override fun shouldRedraw(nextProps: P): Boolean

Returns 'true' when the component should redraw.

stream

fun <T> stream(initial: T, config: Stream<T>.() -> Stream<T>? = null, handler: (T) -> Unit = {}): ComponentStreamProperty<T>

Creates a property that is backed by a StreamSource

subscribingTo

fun <T> subscribingTo(stream: Stream<T>, onNext: (T) -> Unit? = null): ReadOnlyProperty<Any?, T>

Creates a property that is subscribed to a stream.

touch

open override fun touch()

Marks the form field as touched.

triggerRedraw

fun triggerRedraw()

Triggers a redraw

untouch

open override fun untouch()

Marks the form field as not touched.

validate

open override fun validate(): Boolean

Validates all rules and returns true if all rules are fulfilled.

value

fun <T> value(initial: T, onChange: (T) -> Unit? = null): ComponentStateProperty<T>

Creates a read write property for the components state.

Properties

attributes

val attributes: MutableTypedAttributes

The attributes of the component

autoDomKey

val autoDomKey: String

An automatically generated unique dom key for the component instance.

ctx

val ctx: Ctx

currentValue

val currentValue: T

The effective value

dom

val dom: HTMLElement?

The Dom node to which the component is rendered

errors

open override var errors: List<String>

A list of validation errors.

hasErrors

open val hasErrors: Boolean

Returns true when the field has errors

lifecycle

val lifecycle: Component.LifeCycle

The life-cycle LifeCycle that the component exposes

options

val options: O

parent

val parent: Component<*>?

Accessor for the parent component

props

val props: P

Public getter for the Props

touched

open override var touched: Boolean

Track if the input value was modified.

Inheritors

UiCheckBoxComponent

UiInputFieldComponent

UiTextAreaComponent

Extensions

dataLoader

fun <T, C> Component<C>.dataLoader(load: suspend () -> Flow<T>): DataLoader<T>

doubleClickProtection

fun <T> Component<T>.doubleClickProtection(): DoubleClickProtection

formController

fun <T> Component<T>.formController(): FormController

formObserver

fun <T> Component<T>.formObserver(): FormController

messages

val Component<*>.messages: MessagesHandler

Get the MessagesHandler for the Component

onMessage

inline fun <M : Message<*>> Component<*>.onMessage(noinline handler: (M) -> Unit)

Listens for a Message of the given type M.

pagedSearchFilter

fun <C> Component<C>.pagedSearchFilter(router: Router, onChange: (PagedSearchFilter) -> Unit? = null): ReadWriteProperty<Component<C>, PagedSearchFilter>

renderErrors

fun FormField.renderErrors(flow: FlowContent)

sendMessage

fun <M : Message<*>> Component<*>.sendMessage(message: M)

Send the given message.

urlParam

fun <C> Component<C>.urlParam(router: Router, name: String, default: Int, onChange: (Int) -> Unit? = null): ReadWriteProperty<Component<C>, Int>

fun <C> Component<C>.urlParam(router: Router, name: String, default: String, onChange: (String) -> Unit? = null): ReadWriteProperty<Component<C>, String>

urlParams

fun <C, T> Component<C>.urlParams(router: Router, fromParams: (Map<String, String>) -> T, toParams: (T) -> Map<String, Any?>, onChange: (T) -> Unit? = null): ReadWriteProperty<Component<C>, T>