multibox - Render A Checkbox Input Field

Renders an HTML <input> element of type checkbox, whose "checked" status is initialized based on whether the specified value matches one of the elements of the underlying property's array of current values. This element is useful when you have large numbers of checkboxes, and prefer to combine the values into a single array-valued property instead of multiple boolean properties. This tag is only valid when nested inside a form tag body.

WARNING: In order to correctly recognize cases where none of the associated checkboxes are selected, the ActionForm bean associated with this form must include a statement setting the corresponding array to zero length in the reset() method.

The value to be returned to the server, if this checkbox is selected, must be defined by one of the following methods:

Attribute Name Description
accesskey The keyboard character used to move focus immediately to this element. [RT Expr]
alt

The alternate text for this element.

[RT Expr]
altKey

The message resources key of the alternate text for this element.

[RT Expr]
disabled Set to true if this input field should be disabled. [RT Expr]
name The attribute name of the bean whose properties are consulted when rendering the current value of this input field. If not specified, the bean associated with the form tag we are nested within is utilized. [RT Expr]
onblur JavaScript event handler executed when this element loses input focus. [RT Expr]
onchange JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr]
onclick JavaScript event handler executed when this element receives a mouse click. [RT Expr]
ondblclick JavaScript event handler executed when this element receives a mouse double click. [RT Expr]
onfocus JavaScript event handler executed when this element receives input focus. [RT Expr]
onkeydown JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr]
onkeypress JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr]
onkeyup JavaScript event handler executed when this element has focus and a key is released. [RT Expr]
onmousedown JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr]
onmousemove JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr]
onmouseout JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr]
onmouseover JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr]
onmouseup JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr]
property Name of the request parameter that will be included with this submission, set to the specified value. [Required] [RT Expr]
style CSS styles to be applied to this HTML element. [RT Expr]
styleClass CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr]
styleId Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr]
tabindex The tab order (ascending positive integers) for this element. [RT Expr]
title

The advisory title for this element.

[RT Expr]
titleKey

The message resources key for the advisory title for this element.

[RT Expr]
value The value to be transmitted if this checkbox is checked when the form is submitted. [RT Expr]