Smarty - the compiling PHP template engine
Smarty - php 模板编译引擎
Prev Chapter 8. Custom Functions[第八章.自定义函数] Next

html_radios

Attribute NameTypeRequiredDefaultDescription
namestringNoradioname of radio list
valuesarrayYes, unless using options attributen/aan array of values for radio buttons
outputarrayYes, unless using options attributen/aan array of output for radio buttons
checkedstringNoemptythe checked radio element
optionsassociative arrayYes, unless using values and outputn/aan associative array of values and output
separatorstringNoemptystring 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
例 8-9. html_radios 函数演示

index.php:

require('Smarty.class.php');
$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);
$smarty->display('index.tpl');


index.tpl:

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


index.php:

require('Smarty.class.php');
$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);
$smarty->display('index.tpl');


index.tpl:

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


OUTPUT: (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 />
PrevHomeNext
html_optionsUphtml_select_date