PATH |
WOCheckboxMatrix
Component Description
The WOCheckboxMatrix component displays a multi-column array
of checkboxes based on a list of objects and allows the user to
select any combination of these objects. This component displays
its content (everything between the <WEBOBJECT...>
and </WEBOBJECT...>
tags
in the template file) for each of the items in list
in
the same order as WOTable.
This component must be embedded within a WOForm.
Synopsis
WOCheckBoxMatrix { list=anArray; item=anObject; selections=anArray; maxColumns=aNumber; };Bindings
- list
- Array of objects from which the checkboxes derive their
values. For example, the array could be named
movieArray
and contain Movie objects.
- item
- Identifier for the elements of the list. This attribute
is updated for each iteration through
list
. For example,currentMovie
could represent an object inmovieArray
.
- selections
- An array of objects the user chooses from the list.
This attribute is updated when the user submits the form containing
the WOCheckboxMatrix. For the movie example,
selections
array would hold Movie objects.
- maxColumns
- The number of columns of checkboxes displayed.