{html_radios} は
HTML のラジオボタングループを作成する
カスタム関数
です。デフォルトで選択されているアイテムの指定も考慮します。
| 属性名 | 型 | 必須 | デフォルト | 概要 |
|---|---|---|---|---|
| name | string | No | radio | ラジオリストの名前 |
| values | array | Yes (options属性を用いない場合) | n/a | ラジオボタンの値の配列 |
| output | array | Yes (options属性を用いない場合) | n/a | ラジオボタンの項目内容の配列 |
| selected | string | No | empty | あらかじめ選択されたラジオ要素 |
| options | associative array | Yes (valuesとoutput属性を用いない場合) | n/a | values属性とoutput属性の連想配列 |
| separator | string | No | empty | 各ラジオアイテムを区分するための文字列 |
| assign | string | No | empty | radio タグを配列に格納し、出力はしない |
options を使用しない場合は
values および
output が必須となります。
全ての出力は XHTML に準拠しています。
前述の属性リストに無いパラメータが与えられた場合は、
作成された各 <input> タグの内側に
名前/値 のペアで表されます。
Example 8.16. {html_radios} の最初の例
<?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);
?>
テンプレート
{html_radios name='id' values=$cust_ids output=$cust_names
selected=$customer_id separator='<br />'}
Example 8.17. {html_radios} の二番目の例
<?php
$smarty->assign('cust_radios', array(
1000 => 'Joe Schmoe',
1001 => 'Jack Smith',
1002 => 'Jane Johnson',
1003 => 'Charlie Brown'));
$smarty->assign('customer_id', 1001);
?>
テンプレート
{html_radios name='id' options=$cust_radios
selected=$customer_id separator='<br />'}
どちらも、次のように出力します。
<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} - データベース (PEAR あるいは 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));
?>
データベースから割り当てた変数を、次のテンプレートで出力します。
{html_radios name='contact_type_id' options=$contact_types
selected=$contact.contact_type_id separator='<br />'}
{html_checkboxes}
および {html_options}
も参照してください。