What is Smarty?
Why use it?
Use Cases and Work Flow
Syntax Comparison
Template Inheritance
Best Practices
Crash Course
You may use the Smarty logo according to the trademark notice.
For sponsorship, advertising, news or other inquiries, contact us at:
{html_radios}
is a
custom function
that creates a HTML radio button group.
It also takes care of which item is selected by default as well.
Attribute Name | Type | Required | Default | Description |
---|---|---|---|---|
name | string | No | radio | Name of radio list |
values | array | Yes, unless using options attribute | n/a | An array of values for radio buttons |
output | array | Yes, unless using options attribute | n/a | An array of output for radio buttons |
selected | string | No | empty | The selected radio element |
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 radio item |
assign | string | No | empty | Assign radio tags to an array instead of 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 output as
name/value-pairs inside each of the created
<input>
-tags.
Example 8.16. {html_radios} first example
<?php $smarty->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:
{html_radios name='id' values=$cust_ids output=$cust_names selected=$customer_id separator='<br />'}
Example 8.17. {html_radios} second example
<?php $smarty->assign('cust_radios', array( 1000 => 'Joe Schmoe', 1001 => 'Jack Smith', 1002 => 'Jane Johnson', 1003 => 'Charlie Brown')); $smarty->assign('customer_id', 1001); ?>
Where template is:
{html_radios name='id' options=$cust_radios selected=$customer_id separator='<br />'}
Both examples will output:
<label for="id_1000"> <input type="radio" name="id" value="1000" id="id_1000" />Joe Schmoe</label><br /> <label for="id_1001"><input type="radio" name="id" value="1001" id="id_1001" checked="checked" />Jack Smith</label><br /> <label for="id_1002"><input type="radio" name="id" value="1002" id="id_1002" />Jane Johnson</label><br /> <label for="id_1003"><input type="radio" name="id" value="1003" id="id_1003" />Charlie Brown</label><br />
Example 8.18. {html_radios} - Database example (eg PEAR or ADODB):
<?php $sql = 'select type_id, types from contact_types order by type'; $smarty->assign('contact_types',$db->getAssoc($sql)); $sql = 'select contact_id, name, email, contact_type_id ' .'from contacts where contact_id='.$contact_id; $smarty->assign('contact',$db->getRow($sql)); ?>
The variable assigned from the database above would be output with the template:
{html_radios name='contact_type_id' options=$contact_types selected=$contact.contact_type_id separator='<br />'}
See also {html_checkboxes}
and {html_options}