{html_checkboxes}{html_checkboxes} is a
custom function
that creates an html checkbox
group with provided data. It takes care of which item(s) are
selected by default as well.
Attribute NameTypeRequiredDefaultDescriptionnamestringNocheckboxName of checkbox listvaluesarrayYes, unless using options attributen/aAn array of values for checkbox buttonsoutputarrayYes, unless using options attributen/aAn array of output for checkbox buttonsselectedstring/arrayNoemptyThe selected checkbox element(s)optionsassociative arrayYes, unless using values and outputn/aAn associative array of values and outputseparatorstringNoemptyString of text to separate each checkbox itemassignstringNoemptyAssign checkbox tags to an array instead of outputlabelsbooleanNo&true;Add <label>-tags to the output
Required attributes are values and
output, unless you use options
instead.
All output is XHTML compliant.
All parameters that are not in the list above are printed as
name/value-pairs inside each of the created <input>-tags.
{html_checkboxes}
assign('cust_ids', array(1000,1001,1002,1003));
$smarty->assign('cust_names', array(
'Joe Schmoe',
'Jack Smith',
'Jane Johnson',
'Charlie Brown')
);
$smarty->assign('customer_id', 1001);
?>
]]>
where template is
'}
]]>
or where PHP code is:
assign('cust_checkboxes', array(
1000 => 'Joe Schmoe',
1001 => 'Jack Smith',
1002 => 'Jane Johnson',
1003 => 'Charlie Brown')
);
$smarty->assign('customer_id', 1001);
?>
]]>
and the template is
'}
]]>
both examples will output:
Joe Schmoe
]]>
Database example (eg PEAR or ADODB):
assign('contact_types',$db->getAssoc($sql));
$sql = 'select contact_id, contact_type_id, contact '
.'from contacts where contact_id=12';
$smarty->assign('contact',$db->getRow($sql));
?>
]]>
The results of the database queries above would be output with.
'}
]]>
See also
{html_radios}
and
{html_options}