inputCheckbox
For the normal use, value is ignored and the checkbox will render a "checked" attribute if the associated property is not null. When associating with a Set property, the name attribute should specify the value to get/set from the set as an index; if the Set contains the value, the checkbox will be checked, else it will not. On form submission, the Set will be populated with the elements that have been checked in the browser.
A hidden field will be generated after the checkbox to work around the fact that browsers do not submit unchecked checkboxes.
| Tag Information | |
|---|---|
| Tag Class | org.loom.tags.core.InputCheckboxTag |
| Body Content | empty |
| Dynamic Attributes | true |
| Example | <l:inputCheckbox name="mortgage.starred"/>
<c:forEach var="item" items="${items}" >
<li><l:inputCheckbox name="selectedItems[${item.id}]" />
Select item ${item.name}
</li>
</c:forEach> |
Attributes
| Name | Description | Flags |
|---|---|---|
| name | HTML attribute with different meanings: This is the property path inside the action that will be used to get and set the field value. |
requiredrtexprvalue
|
| accesskey | HTML attribute |
rtexprvalue
|
| alt | HTML attribute |
rtexprvalue
|
| bound | true if this field is bound to a java property, defaults to true |
rtexprvalue
|
| class | HTML attribute |
rtexprvalue
|
| decorator | The name of the decorator to use. The default decorators for any form field will display the surrounding label. |
rtexprvalue
|
| dir | HTML attribute |
rtexprvalue
|
| disabled | HTML attribute |
rtexprvalue
|
| escapeHTML | true to sanitize HTML characters when rendering as text, default true |
rtexprvalue
|
| helpLine | If not null, this value will be used as help line |
rtexprvalue
|
| id | HTML attribute |
rtexprvalue
|
| if | Set to false to skip tag execution. |
rtexprvalue
|
| label | If not null, the provided value will be used as field label. Defaults to the name attribute |
rtexprvalue
|
| labelClass | CSS styles to be applied to the surrounding label but not to the input component. This is useful when using grid systems such as 960gs or YUI-Grid |
rtexprvalue
|
| labelPos | Position of the label for this field. Valid values are "left" (default for almost all field types) and "right" (default for checkboxes and radio buttons) |
rtexprvalue
|
| lang | HTML attribute |
rtexprvalue
|
| renderAsText | true to render the field just as text (no form field), default false |
rtexprvalue
|
| renderErrorDisplayComponent | true to render the error message as a separate HTML component, default null |
rtexprvalue
|
| renderLabel | true to render label, false otherwise. By default it will use the value specified in the container form |
rtexprvalue
|
| style | HTML attribute |
rtexprvalue
|
| tabindex | HTML attribute |
rtexprvalue
|
| title | HTML attribute |
rtexprvalue
|
| translateLabel | true to translate label before rendering, false otherwise. defaults to true |
rtexprvalue
|
| translateTitle | set to true to translate title, default true |
rtexprvalue
|
| value | when specified, use this value instead of the action property value |
rtexprvalue
|