## addSelectGroup('name值', '标题', '提示', '选项' [, '默认值', '额外属性', '额外css类']) 标识符:`selectGroup` >[info]1.4.3或更高版本支持。 | 参数 | 含义 | 类型 | | --- | --- | --- | | name | name值 | string | | title | 标题 | string | | tips | 提示 | string | | options | 选项 | array | | default | 默认值 | string | | extra_attr | 额外属性 | string | | extra_class | 额外css类 | string | 用法和【[下拉菜单](%E4%B8%8B%E6%8B%89%E8%8F%9C%E5%8D%95.md)】一致,主要的区别是options参数。 ``` $groups = [ '广州市' => [ '440111' => '白云区', '440106' => '天河区', '440104' => '越秀区' ], '深圳市' => [ '440303' => '罗湖区', '440304' => '福田区', '440305' => '南山区', ] ]; // 使用ZBuilder快速创建表单 return ZBuilder::make('form') ->addFormItems([ // 批量添加表单项 ['selectGroup', 'test', '测试', '', $groups], ]) ->fetch(); ``` 效果: ![](https://img.kancloud.cn/0d/d1/0dd11d0bef7238f4c2cd09a6064f6aff_1029x330.png) >[danger]注意,分组内的键值不可重复,其实就是一个一维数组,按组分开显示,所以键不能重复,一下options写法是错误的。 ``` $groups = [ '广州市' => [ '白云区', '天河区', '越秀区' ], '深圳市' => [ '罗湖区', '福田区', '南山区', ] ]; ``` 上面的数组中,白云区的键是0,罗湖区的键值也是0,键值重复了。 ### 默认值 ``` $groups = [ '广州市' => [ '440111' => '白云区', '440106' => '天河区', '440104' => '越秀区' ], '深圳市' => [ '440303' => '罗湖区', '440304' => '福田区', '440305' => '南山区', ] ]; // 使用ZBuilder快速创建表单 return ZBuilder::make('form') ->addFormItems([ // 批量添加表单项 ['selectGroup', 'test', '测试', '', $groups, '440106'], ]) ->fetch(); ``` ### 多选 ``` $groups = [ '广州市' => [ '440111' => '白云区', '440106' => '天河区', '440104' => '越秀区' ], '深圳市' => [ '440303' => '罗湖区', '440304' => '福田区', '440305' => '南山区', ] ]; // 使用ZBuilder快速创建表单 return ZBuilder::make('form') ->addFormItems([ // 批量添加表单项 ['selectGroup', 'test', '测试', '', $groups, '', 'multiple'], ]) ->fetch(); ```