下拉选择器 picker

通过此部件调用 ZUI 的下拉选择器，详细用法参考 ZUI 文档。

用法

单选

$items = array();
$items[] = array('text' => '编程', 'value' => 'program');
$items[] = array('text' => '阅读', 'value' => 'read');

picker
(
    set::name('hobby'),
    set::value('program'),
    set::items($items)
);

多选

$items = array();
$items[] = array('text' => '编程', 'value' => 'program');
$items[] = array('text' => '阅读', 'value' => 'read');

picker
(
    set::name('hobby'),
    set::value('program,read'),
    set::items($items),
    set::multiple(true)
);

通过 control 部件调用

$items = array();
$items[] = array('text' => '编程', 'value' => 'program');
$items[] = array('text' => '阅读', 'value' => 'read');

control
(
    set::name('hobby'),
    set::value('program,read'),
    set::type('picker'),      // 当指定了 items，此参数可以省略。
    set::items($items),
    set::multiple(true)
);

通过 formGroup 部件调用

$items = array();
$items[] = array('text' => '编程', 'value' => 'program');
$items[] = array('text' => '阅读', 'value' => 'read');

formGroup
(
    set::name('hobby'),
    set::value('program,read'),
    set::control(array('type' => 'picker', 'multiple' => true)),
    set::items($items)
);

属性

名称	类型	可选	默认值	说明
id	string	✓	null	组件根元素的 ID。
className	stringarray	✓	null	类名。
style	array	✓	null	样式。
tagName	string	✓	null	组件根元素的标签名。
attrs	array	✓	null	附加到组件根元素上的属性。
clickType	"toggle""open"	✓	null	点击类型，toggle 表示点击按钮时切换显示隐藏，open 表示点击按钮时只打。
afterRender	function	✓	null	渲染完成后的回调函数。
beforeDestroy	function	✓	null	销毁前的回调函数。
name	string	✓	null	作为表单项的名称。
value	stringstring[]	✓	null	默认值。
emptyValue	string	✓	",0"	默认值。
onChange	function	✓	null	值变更回调函数。
disabled	boolean	✓	null	是否禁用。
multiple	booleannumber	✓	false	是否允许选择多个值，如果指定为数字，则限制多选的数目，默认 false。
required	boolean	✓	null	是否必选（不允许空值，不可以被清除）。
placeholder	string	✓	null	选择框上的占位文本。
valueSplitter	string	✓	null	多个值的分隔字符串，默认为 ,。
items	arrayfunction	—	—	列表项或表项获取方法。
menu	array	✓	null	附加的菜单选项。
hotkey	boolean	✓	null	是否启用快捷键。
search	booleannumber	✓	null	是否启用搜索。
searchDelay	number	✓	null	搜索延迟时间，单位：毫秒。
searchHint	string	✓	null	搜索提示文本。
onDeselect	function	✓	null	当取消选择值时的回调函数。
onSelect	function	✓	null	当选择值时的回调函数。
onClear	function	✓	null	当清空值时的回调函数。
popContainer	string	✓	null	下拉面板容器元素。
popWidth	number"auto""100%"	—	—	菜单宽度，如果设置为 '100%' 则与选择框宽度一致，默认 '100%'。
popHeight	number"auto"	—	—	菜单高度，默认 'auto'。
popMaxHeight	number	✓	null	菜单最大高度，默认 300。
popMinHeight	number	✓	null	菜单最小高度，默认 32。
popMaxWidth	number	✓	null	菜单最大宽度，当宽度设置为 'auto' 时生效。
popMinWidth	number	✓	null	菜单最小宽度，当宽度设置为 'auto' 时生效，默认 50。
popPlacement	"auto""bottom""top""bottom-start""top-end"	✓	null	菜单方向，默认 'auto'。
popClass	stringarray	✓	null	菜单类名。
popStyle	array	✓	null	菜单样式。
onPopShow	function	✓	null	菜单显示时的回调函数。
onPopShown	function	✓	null	菜单显示后的回调函数。
onPopHide	function	✓	null	菜单隐藏时的回调函数。
onPopHidden	function	✓	null	菜单隐藏后的回调函数。