Description

The check box input widget allows for the capturing of data of type boolean.

The widget allows for binding to a basic data type variable directly or to an object instance attribute.

The title is specified as a key to a lang file entry and is required. A tooltip can also be specified as a key to a lang file entry but is optional. Visibility bindings are also supported.

A new addition in version 1.57.0 (specific to the new UI) is the description attribute. The description attribute works similarly to the title in that it is specified as a key to a lang file entry, however, its purpose is to allow for additional information related to an input and will appear beneath the input.

Example

Model object attribute

persistent object Farmer {
    .
    .
    // Attributes for messaging opt-in
    bool emailMessaging;
    .
    .
}

View XML

<checkbox label="checkbox.opt_in_email_messaging">
    <binding variable="farmer">
        <attribute name="emailMessaging"/>
    </binding>
</checkbox>

Backing unit

Farmer farmer;
.
.
void init() {
    farmer = Farmer:user();
}

en.lang file entry

checkbox.opt_in_email_messaging = Opt in for messaging by E-mail:

<checkbox> example screenshots

Browser not supported