T-DOC

单/复选框

Dcat Admin 中文文档 /

单/复选框

单选框

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

基本使用

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

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

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

效果

显示在同一行 (inline)

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

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

$radio = Radio::make($name, $options)->check(1)->inline();

效果

设置禁选的选项 (disable)

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

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

$radio = Radio::make($name, $options)->inline()->disable([2, 3]);

效果

设置样式 (style)

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

设置尺寸

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

small设置为小尺寸

$radio->small();

large设置为大尺寸

$radio->large();

复选框

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

基本用法

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

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

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

效果

全选

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

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

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

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

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

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