Skip to content
scalive
Menu
ConnectingLiveReconnectingOffline
GitHub
c

FormControlItem

class FormControlItem[+Msg]

One checkbox choice within a field, created by item.

Items share raw values, validation, and interaction state with their parent field. They do not add logical fields or hidden fallback inputs. Use a repeated-value codec such as Root.texts for multiple selections; unchecked and disabled items follow native submission rules.

Defined by scalive.FormControlItem. View source (scalive/api/src/scalive/forms/FormBinding.scala:511-560)

Methods3

checkbox

def checkbox[M >: Msg](checkedValue: String, mods: Mod.Input[M]*): HtmlElement[M]

Renders this item's checkbox, checked when the parent's raw values contain checkedValue.

This form takes a fixed token. ARIA remains opt-in through the parent control's validation attributes.

Throws IllegalArgumentException when mods sets an attribute this control owns; see FormControl.

Defined by scalive.FormControlItem.checkbox. View source (scalive/api/src/scalive/forms/FormBinding.scala:531-540)

def checkbox[M >: Msg](checkedValue: Signal[String], mods: Mod.Input[M]*): HtmlElement[M]

Renders this item's checkbox, checked when the parent's raw values contain checkedValue.

This form takes a reactive token without changing item identity. Both token and raw-value changes update checked state; changing the token never rewrites the field's retained values.

Throws IllegalArgumentException when mods sets an attribute this control owns; see FormControl.

Defined by scalive.FormControlItem.checkbox. View source (scalive/api/src/scalive/forms/FormBinding.scala:550-559)

id

def id: Signal[String]

Field-scoped item identity, suitable for a label's forId.

Defined by scalive.FormControlItem.id. View source (scalive/api/src/scalive/forms/FormBinding.scala:518-518)

name

def name: Signal[String]

The parent's exact browser field name, shared by every item.

Defined by scalive.FormControlItem.name. View source (scalive/api/src/scalive/forms/FormBinding.scala:521-521)