## 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();
~~~
![](https://box.kancloud.cn/f1e04614e2c5bf02d800300e53934b45_1186x153.png)
### 默认值
~~~
$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();
~~~
![](https://box.kancloud.cn/f1e04614e2c5bf02d800300e53934b45_1186x153.png)
多选的话,发送到服务器的则为数组形式。
默认值可设置多个,值之间用逗号隔开。
~~~
$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();
~~~