controls/io.nacular.doodle.controls.form/optionalSelectBox

optionalSelectBox

fun <T : Any, M : ListModel<T>> optionalSelectBox(model: M, boxItemVisualizer: ItemVisualizer<T, IndexedItem>, listItemVisualizer: ItemVisualizer<T, IndexedItem> = boxItemVisualizer, unselectedBoxItemVisualizer: ItemVisualizer<Unit, IndexedItem>, unselectedListItemVisualizer: ItemVisualizer<Unit, IndexedItem> = unselectedBoxItemVisualizer, config: (SelectBox<T?, *>) -> Unit = {}): FieldVisualizer<T?>(source)

Creates a SelectBox control that is bound to a Field. This control lets a user select a single item within a list. It is similar to optionalRadioList. This control lets a user ignore selection entirely and therefore the resulting type is T?.

Parameters

T

is the type of the bounded field

model

for the select box

boxItemVisualizer

used to render the drop-down's box item

listItemVisualizer

used to render items in the drop-down's list

unselectedBoxItemVisualizer

used to render the drop-down's box item when it is unselected

unselectedListItemVisualizer

used to render the "unselected item" in the drop-down's list

config

used to control the resulting component

fun <T : Any> optionalSelectBox(first: T, vararg rest: T, boxItemVisualizer: ItemVisualizer<T, IndexedItem>, listItemVisualizer: ItemVisualizer<T, IndexedItem> = boxItemVisualizer, unselectedBoxItemVisualizer: ItemVisualizer<Unit, IndexedItem>, unselectedListItemVisualizer: ItemVisualizer<Unit, IndexedItem> = unselectedBoxItemVisualizer, config: (SelectBox<T?, *>) -> Unit = {}): FieldVisualizer<T?>(source)

Creates a SelectBox control that is bound to a Field. This control lets a user select a single item within a list. It is similar to optionalRadioList. This control lets a user ignore selection entirely and therefore the resulting type is T?.

Parameters

T

is the type of the bounded field

first

item in the list

rest

of the items in the list

boxItemVisualizer

used to render the drop-down's box item

listItemVisualizer

used to render items in the drop-down's list

unselectedBoxItemVisualizer

used to render the drop-down's box item when it is unselected

unselectedListItemVisualizer

used to render the "unselected item" in the drop-down's list

config

used to control the resulting component

fun <T : Any> optionalSelectBox(first: T, vararg rest: T, label: (T) -> String = { "$it" }, unselectedLabel: String, config: (SelectBox<T?, *>) -> Unit = {}): FieldVisualizer<T?>(source)

Creates a SelectBox control that is bound to a Field. This control lets a user select a single item within a list. It is similar to optionalRadioList. This control lets a user ignore selection entirely and therefore the resulting type is T?.

Parameters

T

is the type of the bounded field

first

item in the list

rest

of the items in the list

label

used to render the drop-down's items

unselectedLabel

used to render the item that represents the "unselected" state

config

used to control the resulting component