Introduction

A WOCheckBox object displays itself in the HTML page as its namesake, a check box user interface control. It corresponds to the HTML element <INPUT TYPE="CHECKBOX"...>.

If you want to create a list of check boxes, use the WXCheckBoxList dynamic element in the WebObjects examples.

Usage

WOCheckBox {
  value=defaultValue; 
  [selection=selectedValue;] 
  [name=fieldName;] 
  [disabled=aBoolean;] ... 
}

WOCheckBox {
  checked=aBoolean; 
  [name=fieldName;] 
  [disabled=aBoolean;] ... 
}

Bindings

value

Value of this input element. If not specified, WebObjects provides a default value.

selection

If selection and value are equal when the page is generated, the check box is checked. When the page is submitted, selection is assigned the value of the check box.

checked

During page generation, if checked evaluates to true, the check box appears in the checked state. During request handling, checked reflects the state the user left the check box in: true if checked; false if not.

name

Name that uniquely identifies this element within the form. You may specify a name or let WebObjects automatically assign one at runtime.

disabled

If disabled evaluates to true, this element appears in the page but is not active. That is, selection won't contain the user's selection when the page is submitted.

Examples

Java methods

WOD-style

 

Inline bindings (WOOGNL)

<wo:checkbox name="MyCheck" checked = "~true" />

Related documents

  • No labels