3. check-box
Prev | Chapter 5. Content objects | Next

## 3. check-box

check-box(`key`, `value`, ..., `key`, `value`)

Inserts a check box control in generated content. This control can be used to edit the value of the element which is the target of the CSS rule. If "attribute, `attribute_name`" is specified, this control can be used to edit the value of an attribute of this target element.

Key | Value | Default | Description
--- | --- | --- | ---
attribute | Qualified name of attribute to be edited | No default | Without this parameter, the control is used to edit the value of the element for which the control has been generated.
label | String | None | Label used for the check box.
unchecked-value | String | None | In normal mode, unchecking the control assigns this value to the attribute or element value being edited.
checked-value | String | None | In normal mode, checking the control assigns this value to the attribute or element value being edited.

remove-value

Boolean: yes|no, 1|0, "true"|"false", "on"|"off"

no

Turns remove value mode on and off.

In remove value mode, if unchecked-value is not specified, unchecking the control removes the attribute being edited.

In remove value mode, if checked-value is not specified, checking the control removes the attribute being edited.

If the value being edited is an element value rather than an attribute, this value is set to the empty string.

`Key`, `value`, ..., `key`, `value` may also specify style parameters.

Examples:

    check-box(attribute, value,
              label, "On",
              unchecked-value, "false",
              checked-value, "true")

    check-box(label, "Yes",
              unchecked-value, "no",
              checked-value, "yes")

    check-box(attribute, value,
              label, "Disabled",
              checked-value, "disabled",
              remove-value, yes)

    check-box(label, "Hidden",
              checked-value, "hidden",
              remove-value, yes)

Prev | Up | Next
2. attributes | Home | 4. collapser