## 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(); ``` 效果：  >[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(); ```