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
checked string No empty the checked 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

属性 类型 是否必须 缺省值 描述
name string No radio 单选按钮列表的名称
values array Yes, 或指定 options 属性 n/a 包含单选按钮值的数组
output array Yes, 或指定 options 属性 n/a 包含单选按钮显示值的数组
checked string No empty 已选定的元素
options associative array Yes, 或指定 values 属性 n/a 包含值和显示的关联数组
separator string No empty 分隔每个单选按钮的字符串

html_radios is a custom function that creates html radio button group with provided data. It takes care of which item is selected by default as well. Required attributes are values and output, unless you use options instead. All output is XHTML compatible.

自定义函数 html_radios 根据给定的数据创建单选按钮组. 该函数可以指定哪个元素被选定. 要么必须指定 values 和 ouput 属性,要么指定 options 替代. 所有的输出与 XHTML 兼容.

All parameters that are not in the list above are printed as name/value-pairs inside each of the created <input>-tags.

上表未提到的其它参数在 <input> 标签中以"名称/属性"对的方式显示.

Example 8-9. html_radios
Smarty手册范例 8-9. html_radios 函数演示


$smarty = new Smarty;
$smarty->assign('cust_ids', array(1000,1001,1002,1003));
$smarty->assign('cust_names', array('Joe Schmoe','Jack Smith','Jane
Johnson','Carlie Brown'));
$smarty->assign('customer_id', 1001);


{html_radios values=$cust_ids checked=$customer_id output=$cust_names separator="<br />"}


$smarty = new Smarty;
$smarty->assign('cust_radios', array(
			1001 => 'Joe Schmoe',
			1002 => 'Jack Smith',
			1003 => 'Jane Johnson',
			1004 => 'Charlie Brown'));
$smarty->assign('customer_id', 1001);


{html_radios name="id" options=$cust_radios checked=$customer_id separator="<br />"}

输出结果: (both examples)

<input type="radio" name="id[]" value="1000">Joe Schmoe<br />
<input type="radio" name="id[]" value="1001" checked="checked"><br />
<input type="radio" name="id[]" value="1002">Jane Johnson<br />
<input type="radio" name="id[]" value="1003">Charlie Brown<br />