listcell.formwidget
a <listcell class="formwidget"
should only
appear inside a <listbox class="formwidget"> <listitem>
.
The listcell holds the name, value and label
of one cell. When harvesting, the listbox only recurses the listitems of
a selected row. If the listcell is a type="checkbox"
, it only
returns a value if it is checked. Other listcells always return a value.
When seeding, if a name/value pair matches a single listcell, the whole row
is selected. if the listcell is a type="checkbox"
, it is also checked.
Note: when seeding, if a single cell matches the whole row is selected;
this could also erronuously select some other formwidget listcell in the same row.
But it makes little sense to have multiple <listcell class="formwidget"
in the same row since apparently these values belong together and you
can not change them. A single, "ID" kind of listcell should be enough to
identify the whole row. Usually.
Note2: even though listcells can be checkboxlike, they can't really be checked interactively.
It's probably just a code stub for the listitem type="checkbox"
.
Example:
Additional Attributes:
name
The name of the widget. Used as the name of the variable in CGI
-
onvalidate
pseudo event handler. should point to a method to execute
for validation. when validating, the method will receive a bucket
with a single seed in it, reflecting the name and label of the menulist
and the value of the selected element.
Additional Methods: