跳至内容

{html_options}

{html_options} 是一个 自定义函数,可使用分配数据创建 html <select><option> 组。它会处理哪个(哪些)项目被默认选择。

特性

属性名称 必填 描述
values 是,除非使用选项属性 用于下拉菜单的 value 数组
output 是,除非使用选项属性 用于下拉菜单的 output 数组
selected 所选的选项元素作为一个字符串或数组
options 是,除非使用值和输出 值和输出的关联数组
name 选择组的名称
strict 将会使“额外”属性disabledreadonly仅当它们被提供布尔值TRUE或字符串“disabled”“readonly”时设置(默认为 false)
  • 必需属性为 valuesoutput,除非您使用组合的 options 代替它们。

  • 如果给出了可选的 name 属性,则创建 <select></select> 标记,否则仅生成 <option> 列表。

  • 如果给定的值是一个数组,它将被视为 html <optgroup>,并显示该组。<optgroup> 支持递归。

  • 以上列表中不存在的所有参数均会打印为 <select> 标记内的名称/值对。如果未给出可选的 name,则忽略这些参数。

  • 所有输出均符合 XHTML 标准。

样例

<?php
$smarty->assign('myOptions', [
                                1800 => 'Joe Schmoe',
                                9904 => 'Jack Smith',
                                2003 => 'Charlie Brown']
                                );
$smarty->assign('mySelect', 9904);

下列模板将生成下拉列表。注意存在创建 <select> 标签的 name 属性。

{html_options name=foo options=$myOptions selected=$mySelect}

上述示例的输出如下所示

<select name="foo">
    <option value="1800">Joe Schmoe</option>
    <option value="9904" selected="selected">Jack Smith</option>
    <option value="2003">Charlie Brown</option>
</select>   
<?php
$smarty->assign('cust_ids', [56,92,13]);
$smarty->assign('cust_names', [
                              'Joe Schmoe',
                              'Jane Johnson',
                              'Charlie Brown']);
$smarty->assign('customer_id', 92);

上述数组将使用下列模板输出(注意作为修饰符用于设置 select 大小的 php count() 函数的使用方式)。

<select name="customer_id" size="{$cust_names|@count}">
   {html_options values=$cust_ids output=$cust_names selected=$customer_id}
</select>

上述示例将输出

<select name="customer_id" size="3">
    <option value="56">Joe Schmoe</option>
    <option value="92" selected="selected">Jane Johnson</option>
    <option value="13">Charlie Brown</option>
</select>
<?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));

模板可以如下所示。注意 truncate 修饰符的使用。

<select name="type_id">
    <option value='null'>-- none --</option>
    {html_options options=$contact_types|truncate:20 selected=$contact.type_id}
</select>
<?php
$arr['Sport'] = array(6 => 'Golf', 9 => 'Cricket',7 => 'Swim');
$arr['Rest']  = array(3 => 'Sauna',1 => 'Massage');
$smarty->assign('lookups', $arr);
$smarty->assign('fav', 7);

上述脚本和以下模板

{html_options name=foo options=$lookups selected=$fav}

将输出

<select name="foo">
    <optgroup label="Sport">
        <option value="6">Golf</option>
        <option value="9">Cricket</option>
        <option value="7" selected="selected">Swim</option>
    </optgroup>
    <optgroup label="Rest">
        <option value="3">Sauna</option>
        <option value="1">Massage</option>
    </optgroup>
</select>

另见 {html_checkboxes}{html_radios}