## addSwitch('name值', '标题' [, '提示', '默认值', '属性', '额外属性', '额外css类']) 标识符:`switch` | 参数 | 含义 | 类型 | | --- | --- | --- | | name | name值 | string | | title | 标题 | string | | tips | 提示 | string | | default | 默认值 | string | | attr | 属性 | array | | extra_attr | 额外属性 | string | | extra_class | 额外css类 | string | ### 依然举个栗子 ~~~ return ZBuilder::make('form') ->addSwitch('web_site_status', '站点开关') ->fetch(); ~~~ ![](https://box.kancloud.cn/31b1a3ee0f0272ca4197c30e62ce1cdc_177x88.png) ### 设置默认值 开关的默认值是空,也就是关闭状态,如果需要设置为开启状态,可以这样设置 >[info] 只要默认值不为空,不是0或者'0',其他情况都是开启状态 ~~~ return ZBuilder::make('form') ->addSwitch('web_site_status', '站点开关', '', '1') ->fetch(); ~~~ ![](https://box.kancloud.cn/33d711e08ec72813d7c23bfab5bf6d13_246x79.png) >[danger] 注意:如果开关为关闭状态时,提交表单的时候不会发送该表单项的name值,打开状态时才会,并且值为“on”。 >开发者需要自行判断是否有该项。 ### 定义属性 可以设置颜色、尺寸、形状 #### 颜色(color) * `primary` (默认) * `default` * `info` * `success` * `warning` * `danger` ~~~ return ZBuilder::make('form') ->addSwitch('web_site_status', '站点开关', '', '1', ['color' => 'danger']) ->fetch(); ~~~ ![](https://box.kancloud.cn/083fa28d5172cc831db02f4afbf4f23e_100x70.png) #### 尺寸(size) * `sm` (默认) * `nm` * `lg` ~~~ return ZBuilder::make('form') ->addSwitch('web_site_status', '站点开关', '', '1', ['size' => 'lg']) ->fetch(); ~~~ ![](https://box.kancloud.cn/b9eb157508a028eb9cd31c2b36badbb6_134x68.png) #### 形状(shape) * `rounded` (默认) * `square` ~~~ return ZBuilder::make('form') ->setPageTitle('添加') ->addSwitch('web_site_status', '站点开关', '', '1', ['shape' => 'square']) ->fetch(); ~~~ ![](https://box.kancloud.cn/63dbbb35e783a3a576db81176c8cc9bf_137x62.png) 三种属性可以一起使用 ~~~ return ZBuilder::make('form') ->setPageTitle('添加') ->addSwitch('web_site_status', '站点开关', '', '1', ['color' => 'danger', 'size' => 'lg', 'shape' => 'square']) ->fetch(); ~~~ ### 添加额外属性 比如默认为禁用状态 ~~~ return ZBuilder::make('form') ->setPageTitle('添加') ->addSwitch('web_site_status', '站点开关', '', '1', '', 'disabled') ->fetch(); ~~~