Attribute Name | Type | Required | Default | Description |
---|---|---|---|---|
name | string | No | checkbox | name of checkbox list |
values | array | Yes, unless using options attribute | n/a | an array of values for checkbox buttons |
output | array | Yes, unless using options attribute | n/a | an array of output for checkbox buttons |
selected | string/array | No | empty | the selected checkbox element(s) |
options | associative array | Yes, unless using values and output | n/a | an associative array of values and output |
separator | string | No | empty | string of text to separate each checkbox item |
labels | boolean | No | true | add <label>-tags to the output |
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. Required attributes are values and output, unless you use options instead. All output is XHTML compatible.
All parameters that are not in the list above are printed as name/value-pairs inside each of the created <input>-tags.