addSelect('name值', '标题', '提示', '选项' [, '默认值', '额外属性', '额外css类'])

标识符:select

版本 新增功能
1.0.7 支持自定义placeholder
参数 含义 类型
name name值 string
title 标题 string
tips 提示 string
options 选项 array
default 默认值 string
extra_attr 额外属性 string
extra_class 额外css类 string

下拉菜单的用法和复选、单选类似。

简单的例子

return ZBuilder::make('form')
    ->addSelect('city', '选择城市', '', ['gz' => '广州', 'sz' => '深圳', 'sh' => '上海'])
    ->fetch();

默认值

$list_city = ['gz' => '广州', 'sz' => '深圳', 'sh' => '上海'];

return ZBuilder::make('form')
    ->setPageTitle('添加')
    ->addSelect('city', '选择城市', '请选择城市', $list_city, 'gz')
    ->fetch();

多选

下拉菜单也可以设置为多选,只要添加额外属性为“multiple”即可。

$list_city = ['gz' => '广州', 'sz' => '深圳', 'sh' => '上海'];

return ZBuilder::make('form')
    ->setPageTitle('添加')
    ->addSelect('city', '选择城市', '请选择城市', $list_city, '', 'multiple')
    ->fetch();

多选的话,发送到服务器的则为数组形式。

默认值可设置多个,值之间用逗号隔开。

$list_city = ['gz' => '广州', 'sz' => '深圳', 'sh' => '上海'];

return ZBuilder::make('form')
    ->setPageTitle('添加')
    ->addSelect('city', '选择城市', '请选择城市', $list_city, 'gz,sh', 'multiple')
    ->fetch();

自定义placeholder

从1.0.7版本开始,可以自定义表单项的placeholder,只需在title后面添加“[:提示文字]”,如:

$list_city = ['gz' => '广州', 'sz' => '深圳', 'sh' => '上海'];

return ZBuilder::make('form')
    ->setPageTitle('添加')
    ->addSelect('city', '选择城市[:请选择一个城市]', '请选择城市', $list_city, 'gz,sh', 'multiple')
    ->fetch();