选择框 select

用法

一般用法

实现一个 HTML5 的选择框，通过 items 属性指定可选项。

zin 声明

$modules = array();
$modules[] = array('text' => '/',        'value' => 0);
$modules[] = array('text' => '/Website', 'value' => 1);

select
(
    set::name('modules'),
    set::items($modules),
    set::value(0)
);

生成的 HTML

<select class="form-control" name="module" id="module">
  <option value=""></option>
  <option value="0" selected="selected">/</option>
  <option value="1">/Website</option>
</select>

设置选项列表

通过 items 属性来设置选项列表，该属性拥有多种形式，下面分别进行说明。

通过关联数组的键值对分别设置每个选项的值和显示文本，例如：

zin 声明

$items = array();
$items['home'] = '首页';
$items['blog'] = '博客';

select
(
    set::name('pages'),
    set::items($items)
);

生成的 HTML

<select class="form-control" name="pages" id="pages">
  <option value="" selected></option>
  <option value="home">首页</option>
  <option value="blog">博客</option>
</select>

通过具有 text 和 value 属性的数组的数组来指定每一个选项，上例的 $items 可以改写为：

$items = array();
$items[] = array('text' => 'home', 'text' => '首页');
$items[] = array('text' => 'blog', 'text' => '博客');

通过 item() 来指定每个选项，上例可以改写为：

select
(
    set::name('pages'),
    item
    (
        set::value('home'),
        set::text('首页')
    ),
    item(set(array('value' => 'blog', 'text' => '博客')))
);

允许空选项

当 required 属性为 false 时会视为允许空选项，此时如果没有通过 items 属性提供 value 为空字符串 '' 的选项，则会自动添加一个空选项在选项列表的最前面。

zin 声明

$modules = array();
$modules[] = array('text' => '/',        'value' => 0);
$modules[] = array('text' => '/Website', 'value' => 1);

select
(
    set::name('modules'),
    set::required(false),
    set::items($modules),
    set::value(0)
);

生成的 HTML

<select class="form-control" name="module" id="module">
  <option value=""></option>
  <option value="0" selected="selected">/</option>
  <option value="1">/Website</option>
</select>

属性

属性名	类型	默认值	说明
name	string	-	控件名称
items	array	-	选项列表
id	string	与 name 一致	元素 id
class	string	'form-control'	元素类名
value	string	''	初始值
required	bool	false	是否为必填
multiple	bool	false	是否为多选
disabled	bool	false	是否禁用