{html_options}

{html_options} 是一个自定义函数，用于创建带有指定数据的 HTML <select><option> 组。它还会处理默认情况下选择的项目。

属性

属性名	必需	描述
values	是	下拉列表的值的数组
output	是	下拉列表的输出的数组
selected	否	选中的选项元素，可以是字符串或数组
options	是	值和输出的关联数组
name	否	select 组的名称
strict	否	如果提供了布尔值 TRUE 或字符串 "disabled" 和 "readonly"，则只会设置 "extra" 属性 disabled 和 readonly（默认为 false）

• 必需的属性是 values 和 output，除非使用组合的 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);

以下模板将生成一个下拉列表。请注意 name 属性的存在，它创建了 <select> 标签。

{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);

上述数组将与以下模板一起输出（注意使用 php 的 count() 函数作为修饰符来设置 select 的大小）。

<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}。