单/复选框

# 单/复选框

## 单选框

通过 `Dcat\Admin\Widgets\Radio`类可以很方便地快速构建单选框表单。

### 基本使用

```php
<?php
use Dcat\Admin\Widgets\Radio;

// 表单 name 属性
$name = 'state';
// 选项
$options = [
   1 => '未处理',
   2 => '已处理',
   3 => '已拒绝',
];

$radio = Radio::make($name, $options)->check(1); // 选中第一个选项
```

效果
![](http://docs.oneself.icu:10010/storage/markdown/images/e146c7e34f2f58a98b02f436383b2952667bc0a66e46a.png)

### 显示在同一行 (inline)

```php
<?php
use Dcat\Admin\Widgets\Radio;

$name = 'state';
$options = [
   1 => '未处理',
   2 => '已处理',
   3 => '已拒绝',
];

$radio = Radio::make($name, $options)->check(1)->inline();
```
效果
![](http://docs.oneself.icu:10010/storage/markdown/images/4556f7ad3960f1b46affcd17da857db4667bc0af947c3.png)

### 设置禁选的选项 (disable)

```php
<?php
use Dcat\Admin\Widgets\Radio;

$name = 'state';
$options = [
   1 => '未处理',
   2 => '已处理',
   3 => '已拒绝',
];

$radio = Radio::make($name, $options)->inline()->disable([2, 3]);
```
效果
![](http://docs.oneself.icu:10010/storage/markdown/images/5856196fcddc2a76bbdac031589dc80c667bc0ba61345.png)

### 设置样式 (style)

通过`style`方法可以设置单选框的样式，支持`primary`、`info`、`success`、`danger`。

### 设置尺寸

单选框支持3种尺寸，使用方法如下

`small`设置为小尺寸
```php
$radio->small();
```

`large`设置为大尺寸
```php
$radio->large();
```

## 复选框

通过 `Dcat\Admin\Widgets\Checkbox`类可以很方便地快速构建复选框表单，并且复选框类是属于`Radio`的子类，因此用法与`Radio`类基本一致。

### 基本用法

```php
<?php
use Dcat\Admin\Widgets\Checkbox;

// 表单 name 属性，因为此处是多选，所以需要加上中括号
$name = 'hobbies[]';
// 选项
$options = [
   1 => '唱',
   2 => '跳',
   3 => 'RAP',
   4 => '打篮球',
];

$checkbox = Checkbox::make($name, $options)
    ->inline()
    ->check([1, 2]); // 这里允许传递数组，默认选中多个选项
```

效果
![](http://docs.oneself.icu:10010/storage/markdown/images/f252035351006b081f2e0f964a545462667bc0c74f0a1.png)

### 全选

通过`checkAll`方法可以选中全部选项。

```php
<?php
use Dcat\Admin\Widgets\Checkbox;

// 表单 name 属性，因为此处是多选，所以需要加上中括号
$name = 'hobbies[]';
// 选项
$options = [
   1 => '唱',
   2 => '跳',
   3 => 'RAP',
   4 => '打篮球',
];

$checkbox = Checkbox::make($name, $options)
    ->inline()
    ->checkAll(); // 全部选中
```

`checkAll`方法也允许全选的同时排除指定选项。

```php
$checkbox = Checkbox::make($name, $options)
    ->inline()
    ->checkAll([1, 3]); // 全部选中，但是排除key为1和3的选项
```

### 更多用法

更多用法与`Radio`的用法一致，这里不再赘述。

目录

内容导航

单/复选框