BETA版本更新日志

v2.0.20-beta

发布时间 2021/3/8

升级方法，逐步执行以下命令，并清除浏览器缓存

composer remove dcat/laravel-admin
composer require dcat/laravel-admin:"2.0.20-beta"
php artisan admin:publish --assets --migrations --force
php artisan migrate

功能改进

1.selectTable表单表格刷新时保留前页的数据状态

selectTable表单表格刷新或翻页后会保留前页选中或取消的数据状态

2.selectTable表单设置显示字段名称功能优化

在旧版本中，如果想要设置selectTable表单选中的字段或显示的字段，需要在Renderable对象中设置，非常的麻烦和不便，从当前版本开始，开发者可以直接通过下面的方法设置选中的字段或显示的字段

<?php
$form->selectTable('user_id')
       ->from(UserTable::make())
     ->pluck('full_name', 'id'); // 第一个参数为显示的字段，第二个参数为选中后将保存到表单的字段
// 也可以直接使用下面的方法
$form->selectTable('user_id')
       ->from(UserTable::make())
       ->model(UserModel::class, 'id', 'full_name');

3.selectTable、multipleSelectTable、radio、checkbox表单增加load方法

从当前版本开始，selectTable、multipleSelectTable、radio、checkbox也可以使用load方法联动select和multipleSelect表单

<?php

$form->radio('type')->options([...])->load('category', 'categories/options');

$form->select('categories');

接口categories/options返回格式如下

[
    {
        "id": 9,
        "text": "xxx"
    },
    {
        "id": 21,
        "text": "xxx"
    },
    ...
]

4.增加菜单水平布局自动适应页面以及菜单高度变化功能

启用菜单水平布局功能后，当页面高度或菜单高度发生变动时，页面会自适应、自行调整内容间距

5.增加表格Grid::dropColumn()方法用于删除设置的列

<?php

$nameColumn = $grid->column('name');

// 删除名称为 `name` 的列
$grid->dropColumn('name');
// 等同于
$grid->dropColumn($nameColumn);

6.增加admin_javascript函数

此函数可用于往php的配置array中添加JS代码，用法如下

<?php

$form->text('number')->inputmask([
    'oncomplete' => admin_javascript('function () {
        // 这里是js代码
        alert('inputmask complete');
    }'),
]);

6.Form表单底部可默认勾选查看、继续编辑、继续创建等选项功能

用法如下 #1073

<?php

$form->footer(function (Footer $footer) {
    // 设置`查看`默认选中
    $footer->defaultViewChecked();

    // 设置`继续编辑`默认选中
    $footer->defaultEditingChecked();

    // 设置`继续创建`默认选中
    $footer->defaultCreatingChecked();
});

// 设置`查看`默认选中
$form->defaultViewChecked();

// 设置`继续编辑`默认选中
$form->defaultEditingChecked();

// 设置`继续创建`默认选中
$form->defaultCreatingChecked();

BUG

1. 修复表格使用关联关系字段排序时必须先with问题
2. 修复同个页面无法同时渲染多个异步组件问题
3. 修复树形表格下删除子节点数据后跳转异常问题 #1071
4. 修复表格导出字段中存在空数组时导出异常问题
5. 修复表单多图上传使用sortable功能进行排序会导致页面的图片元素消失不见问题
6. 修复表单字段disable方法设置false无效问题
7. 修复multipleSelect表单使用load联动加载时无法把所有选中选项传入接口问题 #1076
8. 修复表格规格选择器存在多个0开头选项时选中功能异常问题

BUG

1. 修复表格使用关联关系字段排序时必须先with问题
   2. 修复同个页面无法同时渲染多个异步组件问题
   3. 修复树形表格下删除子节点数据后跳转异常问题 #1071
   4. 修复表格导出字段中存在空数组时导出异常问题
   5. 修复表单多图上传使用sortable功能进行排序会导致页面的图片元素消失不见问题
   6. 修复表单字段disable方法设置false无效问题
   7. 修复multipleSelect表单使用load联动加载时无法把所有选中选项传入接口问题 #1076
   8. 修复表格规格选择器存在多个0开头选项时选中功能异常问题

v2.0.19-beta

发布时间 2021/2/21

升级方法，逐步执行以下命令，并清除浏览器缓存

composer remove dcat/laravel-admin
composer require dcat/laravel-admin:"2.0.19-beta"
php artisan admin:publish --assets --migrations --force
php artisan migrate

BUG修复

1. 修复非超管角色下请求 内置api 时提示 无权访问 问题
   2. 修复在弹窗中使用时间范围表单报错问题

v2.0.18-beta

发布时间 2021/2/20

升级方法，逐步执行以下命令，并清除浏览器缓存

composer remove dcat/laravel-admin
composer require dcat/laravel-admin:"2.0.18-beta"
php artisan admin:publish --assets --migrations --force
php artisan migrate

功能改进

1.增加菜单顶部横向布局 (Horizontal)

设置配置参数 admin.layout.horizontal_menu 的值为 true 开启此功能，效果如下

2.权限中间件以及跳过登陆判断时可以填写路由别名并且无需增加前缀

配置文件以及权限设置路由别名时无需填写路由前缀

<?php

    'permission' => [
        ...

        // 跳过权限判断
        'except' => [
            // 可以直接填写路由别名，并且无需写路由前缀
            'custom.users',
        ],

    ],

3.数据表格行数据增加 _index 字段用于保存行序号

数据表格行数据增加 _index 字段用于保存行序号，从 0 开始，用法如下

<?php

// 在 display 回调中使用
$grid->column('序号')->display(function () {
    return $this->_index + 1;
});


// 在行操作 action 中使用
$grid->actions(function ($actions) {
    $index = $this->_index;

    ...
});

4.重命名 markdown 组件静态资源别名，避免与自定义 blade 标签产生冲突

5.增加配置参数 admin.menu.default_icon 用于设置默认菜单图标

admin.menu.default_icon 用于设置菜单默认图标，默认值为 feather icon-circle

6.增加新的区块位置 NAVBAR_BEFORE 以及 NAVBAR_AFTER

<?php

use Dcat\Admin\Admin;

// 往顶部导航栏前输出内容
admin_inject_section(Admin::SECTION['NAVBAR_BEFORE'], view('...'));

// 往顶部导航栏后输出内容
admin_inject_section(Admin::SECTION['NAVBAR_AFTER'], view('...'));

6.优化表格字段选择器代码

BUG修复

1. 修复扩展管理页面new标签显示异常问题 #1044
2. 修复文件上传成功后直接删除报错问题 #1058
3. 修复 Form::number 表单在使用 min 和 max 方法后输入值异常问题

v2.0.17-beta

发布时间 2021/2/5

升级方法，逐步执行以下命令，并清除浏览器缓存

composer remove dcat/laravel-admin
composer require dcat/laravel-admin:"2.0.17-beta"
php artisan admin:publish --assets --migrations --force
php artisan migrate

破坏性变动

1.路由别名调整
所有后台的路由别名都会自动增加前缀，需要通过 admin_route 函数获取路由URL，admin_route 可以完全代替 Laravel 内建的 route 方法，且支持单一方法请求的路由别名，以下是一些合法范例：

admin_route('records')，资源路由和方法路由的别名。

admin_route('records',['id' => 1])，附带请求参数。

功能改进

1.优化表格排序功能

支持orderBy直接使用关联关系表字段进行排序，注意这里仅支持一对一以及一对多关联关系

<?php

$grid->model()->orderBy('profile.age');

2.增加模型树以及树形表格自定义顶级parent_id值功能

模型树以及树形表格可以在model中自定义顶级parent_id值，默认值为0

<?php

class Category extends Model
{
    use ModelTree;

    // 设置默认 parent_id 为 A
    protected $defaultParentId = 'A';
}

3.数据详情 file 支持展示多文件

#985

<?php

$show->field('...')->files();

效果

4.Form::input支持数组批量设置

<?php

$form->submitted(function ($form) {
    $form->input(['k1' => 'v1', 'k2' => 'v2' ...]);
});

5.扩展管理支持logo以及别名展示

详细用法参考文档 扩展

6.增加admin_route方法根据别名获取URL

app/Admin/routes.php路由注册如下

<?php

Route::group([
    'prefix'        => config('admin.route.prefix'),
    'namespace'     => config('admin.route.namespace'),
    'middleware'    => config('admin.route.middleware'),
], function (Router $router) {
    // 设置别名
    $router->resource('users', 'UserController', [
        'names' => ['index' => 'my-users'],
    ]);

});

根据别名获取URL

<?php

// 获取url
$url = admin_route('my-users');

// 判断路由
$isUsers = request()->routeIs(admin_route_name('users'));

8.JsonResponse::location 允许不传参

如果不传参会在1秒之后自动刷新当前页面

<?php

return Admin::json()->success('操作成功')->location();

9.页面布局Layout\Column支持等宽布局

当列宽度设置为0时会使用等宽布局 #1018

<?php

use Dcat\Admin\Layout\Row;
use Dcat\Admin\Layout\Content;

return Content::make()
              ->body(function (Row $row) {
                  $row->column(0, view('...'));
              });

10.页面布局Layout\Row支持no-gutters属性

.row上带有margin-left: -15px;margin-right: -15px;属性，你可以在.row上上定义.no-gutters属性，从而消除这个属性，使页面不会额外宽出30px，即<div class="row no-gutters"...

<?php

$content->row(function (Row $row) {
    // 启用 no-gutters
    $row->noGutters();

    $row->column(9, function (Column $column) {
        $column->row($this->card(['col-md-12', 20], '#4DB6AC'));

        $column->row(function (Row $row) {
            // 启用 no-gutters
            $row->noGutters();

            $row->column(4, $this->card(['col-md-4', 30], '#80CBC4'));
            $row->column(4, $this->card(['col-md-4', 30], '#4DB6AC'));
            $row->column(4, function (Column $column) {
                $column->row(function (Row $row) {
                    // 启用 no-gutters
                    $row->noGutters();

                    $row->column(6, $this->card(['col-md-6', 30], '#26A69A'));
                    $row->column(6, $this->card(['col-md-6', 30], '#26A69A'));
                });
            });
        });
    });
});

效果如下

11.表格删除数据后保留URL的get参数

在之前的版本中，删除数据后会丢失URL的get参数，导致跳转回表格第一页，这个版本对这个功能进行了优化，删除后依然会保留URL的get参数 #961

12.重构文件上传前端代码

此功能为技术性优化，这个版本对文件上传前端代码进行了重构、拆分代码，使其更易阅读和维护

BUG修复

1. 修复MultipleSelect表单样式异常问题 #967
2. 修复加载markdown组件后使用select2表单异常问题 #990
3. 修复文件上传在Linux服务器下保存繁体中文文件名丢失问题 #993
4. 修复 Widgets\Dropdown::click 无法显示默认选项问题
5. 修复form表单中的number组件文本内容为空时点击加减按钮出现NaN问题 #995
6. 修复图片预览失败提示无法使用翻译文件问题
7. 修复一对一关联关系Range表单使用验证规则判断异常问题
8. 修复多应用情况下路由别名冲突的问题

v2.0.16-beta

发布时间 2021/1/11

升级方法，逐步执行以下命令，并清理浏览器缓存

composer remove dcat/laravel-admin
composer require dcat/laravel-admin:"2.0.16-beta"
php artisan admin:publish --assets --migrations --force
php artisan migrate

破坏性变动

1.表单字段的 disableHorizontal 调整为 horizontal

更改表单字段布局方式为horizontal，此功能默认启用，用法如下

<?php

// 禁用 horizontal 布局
$form->text('...')->horizontal(false);

功能改进

1.增强表格字段排序(sortable)功能

使表格字段支持关联关系表字段以及json字段的排序

注意，关联关系仅支持hasOne以及belongsTo两种类型的字段排序，并且不支持多层级嵌套！

<?php

// 关联关系表字段排序
$grid->column('profile.age')->sortable();

// 指定需要排序的字段名称
$grid->column('my_age')->sortable('profile.age');

// json字段排序
$grid->column('options.price')->sortable('options->price');
// 关联关系表的 json 字段排序
$grid->column('profile.options.price')->sortable('profile.options->price');

支持MySql的order by cast({field}as {type})用法

<?php

$grid->column('profile.age')->sortable(null, 'SIGNED');

$grid->column('profile.options.price')->sortable('profile.options->price', 'SIGNED');

2.增加 admin_exit 函数，用于代替 exit

admin_exit 用于中断程序执行，并响应数据到浏览器进行显示，用于代替 exit 和 die，下面简单介绍下用法

用法1，返回 Content 布局对象，此用法可用于返回错误信息显示到前端

<?php

use Dcat\Admin\Widgets\Alert;
use Dcat\Admin\Layout\Content;

// 中断程序，并显示自定义页面到前端
admin_exit(
    Content::make()
           ->title('标题')
           ->description('描述')
           ->body('页面内容1')
           ->body(Alert::make('服务器出错了~', 'Error')->danger())
);

效果如下

用法2，返回 json 格式数据，此用法经常用于表单提交数据的api请求拦截，或Action的api请求拦截

<?php

use Dcat\Admin\Admin;

admin_exit(
    Admin::json()
         ->success('成功了')
         ->refresh()
         ->data([
             ...
         ])
);

// 当然也可以直接响应数组
admin_exit([
   ...
]);

用法3，直接相应Response对象或字符串

<?php

admin_exit('Hello world');

admin_exit(response('Hello world', 500));

3.增加 Show\Field::bool() 和 Show\Field::bold() 方法

字段值为真显示 ✓, 否则显示 ✗ #940

<?php

$show->field('...')->bool();

字段值加粗显示

$show->field('...')->bold();

// 指定颜色
$show->field('...')->bold(admin_color()->primary());

4.增加 Form\Footer::view() 方法

通过 Form\Footer::view() 方法可以自定义数据表单的底部视图 #957

<?php

$form->footer(function ($footer) {
    $footer->view('...', [...]);
});

5.增加表单默认显示指定 Tab 功能

<?php

// 默认显示标题为 标题2 的 Tab
$form->getTab()->active('标题2');
// 也可以指定偏移量
$form->getTab()->activeByIndex(1);

$form->tab('标题1', function ($form) {
    ...
});

$form->tab('标题2', function ($form) {
    ...
});

6.增加表单 Form\Row::horizontal() 方法

设置布局为 horizontal

<?php

$form->row(function (Form\Row $form) {
    $form->horizontal();

    ...
});

7.表格 Modal 增加自定义图标功能

<?php

$grid->column('...')->modal(function ($modal) {
    // 自定义图标
    $modal->icon('feather icon-x');

    return ...;
});

8.增加路由域名限制配置

通过配置参数admin.route.domain可以限制路由的域名, 打开配置文件 config/admin.php

<?php

    'route' => [
        'domain' => env('ADMIN_ROUTE_DOMAIN'),

        'prefix' => env('ADMIN_ROUTE_PREFIX', 'admin'),

        'namespace' => 'App\\Admin\\Controllers',

        'middleware' => ['web', 'admin'],
    ],

9.增加 admin.session 中间件的启用或禁用配置

从2.0的版本之后 admin.session 中间件不再默认启用，如果您的应用同时有前台和后台，则需要开启 admin.session 中间件，否则会造成前后台 session 冲突问题。

把配置参数 admin.route.enable_session_middleware 的值设置为 true 即可开启

<?php

    'route' => [
        'domain' => env('ADMIN_ROUTE_DOMAIN'),

        'prefix' => env('ADMIN_ROUTE_PREFIX', 'admin'),

        'namespace' => 'App\\Admin\\Controllers',

        'middleware' => ['web', 'admin'],

        // 开启 admin.session 中间件
        'enable_session_middleware' => true,
    ],

BUG修复

1. 修复数据表格Grid::header以及Grid::footer回调的第一个参数中Model被转化为array格式问题
2. 修复切换主题时文件上传按钮颜色无法跟着改变问题 #938
3. 修复 Widgets\Table 构造方法第三个参数设置无效问题
4. 修复 app/Admin/bootstrap.php 中使用 config(['admin.layout.color' => '...']) 覆盖主题色可能无效问题
5. 修复数据表格过滤器重置关联关系表单字段无效问题 #949
6. 修复表格过滤器 group 功能显示异常问题 #929
7. 修复当页面存在多个 selectTable 表单时所有弹窗都只显示第一个设置的 title 问题 #926

v2.0.15-beta

发布时间 2021/1/3

升级方法，逐步执行以下命令

composer remove dcat/laravel-admin
composer require dcat/laravel-admin:"2.0.15-beta"
php artisan admin:publish --assets --migrations --force
php artisan migrate

功能改进

1.升级select2到v4.1.x-beta版本

select组件升级至v4.1.x-beta，使tags表单体验更好，并支持了多国语言翻译。

2.Widgets/Modal增加弹窗垂直居中以及可滚动功能

用法如下 #901

<?php

$modal = Modal::make()
              ->xl()
              ->centered() // 设置弹窗垂直居中
              ->scrollable() // 设置弹窗内容可滚动
              ->title(...)
              ->body(...);

3.Admin::requiredAssets支持传递动态参数

<?php

use Dcat\Admin\Admin;

// 注册前端组件别名
// {lang} 为动态参数
Admin::asset()->alias('@test', [
    'js' => ['/vendor/test/js/{lang}.min.js'],
]);

// {lang} 会被替换为 zh_CN
Admin::requireAssets('@test', ['lang' => 'zh_CN']);
// 也可以这样使用
Admin::requireAssets('@test?lang=zh_CN');

Bug修复

1. 修复表单block布局无法保存数据问题 #883
2. 修复hasMany表单下使用currency失效问题 #886
3. 修复数据表单保存后自动跳转到详情页问题 #893
4. 修复editor表单无法清空数据问题 #895
5. 修复hasMany表单下使用tags的required验证异常问题 #905
6. 修复多文件上传表单删除单个文件时会导致全部文件被清空问题 #914
7. 修复表格字段无法使用模型访问器问题

v2.0.14-beta

发布时间 2020/12/24

升级方法，逐步执行以下命令

composer remove dcat/laravel-admin
composer require dcat/laravel-admin:"2.0.14-beta"
php artisan admin:publish --assets --migrations --force
php artisan migrate

功能改进

1.优化文件上传失败错误信息提示

在旧版本中，文件上传失败的错误提示信息不太明确，导致难以定义错误原因，所以在这个版本中对错误提示进行了优化，一旦文件上传失败会显示具体原因。

Bug修复

1. 修复表格字段与模型casts属性产生冲突，以及display闭包中使用字符串拼接显示异常问题 #876
   2. 修复表单动态显示功能无法使用问题 #879
   3. 修复表单使用Block布局时无法显示编辑数据问题 #877

v2.0.13-beta

发布时间 2020/12/23

升级方法，逐步执行以下命令

composer remove dcat/laravel-admin
composer require dcat/laravel-admin:"2.0.13-beta"
php artisan admin:publish --assets --migrations --force
php artisan migrate

Bug修复

1. 修复表格展示关联关系字段当关联数据不存在时有可能报错问题 #867
   2. 修复当表格使用数据仓库返回数组或非模型collection时display方法无效问题 #869

v2.0.12-beta

发布时间 2020/12/22

升级方法，逐步执行以下命令

composer remove dcat/laravel-admin
composer require dcat/laravel-admin:"2.0.12-beta"
php artisan admin:publish --assets --migrations --force
php artisan migrate

破坏性变动

1.图片/文件上传表单removeable重命名为removable

<?php

$form->file('...')->removable();

功能改进

1.支持PHP8.0

2.图片/文件上传表单支持监听WebUploader事件

通过 on 方法可以监听 WebUploader文件上传相关事件

<?php

$form->file('...')
         ->on('startUpload', <<<JS
            function () {
              console.log('文件开始上传...', this);

              // 上传文件前附加自定义参数到文件上传接口
              this.uploader.options.formData['custom_field'] = '...';
            }
                JS
    )
      ->on('uploadFinished', <<<JS
            function () {
              console.log('文件上传完毕');
            }
             JS
    );

3.监听文件上传成功或文件被删除时产生的变动

通过以下方法可以监听文件上传成功或文件被删除时产生的变动

<?php

$file = $form->file('...');

Admin::script(
      <<<JS
          $('{$file->getElementClassSelector()} .file-input').on('change', function () {
            console.log('文件发生变动', this.value);
          });
      JS
);

4.允许在uploading事件中拦截并响应错误信息

从这个版本开始支持在表单的 uploading 事件中拦截文件上传并支持响应错误信息到前端

<?php

$form->uploading(function (Form $form) {
    return $form->response()->error('文件上传失败，请重试！');
});

5.监听selectTable选中值变动

<?php

$selectTable = $form->selectTable('...')->from(...);

Admin::script(
    <<<JS
    $('{$selectTable->getElementClassSelector()} input[type="hidden"]').on('change', function () {
      console.log('选中值发生变化', this.value);
    });
    JS
);

6.调整树状表格无数据返回，取消返回404状态码

7.调整表格displayer类的row属性值类型为model

8.暗黑模式细节优化

<?php

$grid->column(...)->modal(function () {
    // $this 指向 model 对象
    dd($this);
});

$grid->actions(function () {
    // $this 指向 model 对象
    dd($this);
});

9.优化卡片中图表显示溢出的问题

#822

10.widget组件增加when方法

<?php

$modal = Dcat\Admin\Widgets\Modal::make()
          ->when($condition, function ($modal) {
            // 当 $condition 的值为 真 时，会执行闭包里面的逻辑
              $modal->xl();
          })
          ->body(...)
          ->render();

Bug修复

1. 修复 Grid\Filter::group 无法保持选择状态问题 #739
   2. 修复 Form::hasMany 表单条目删除后仍然验证 required 问题 #795
   3. 修复 地图 表单无法使用问题
   4. 修复当生成 composer 类映射文件且类文件被删除的情况下使用 guessClassFileName 会报错问题
   5. 修复数据导出使用 Fetched 事件报错问题 #815
   6. 修复设置 Grid name 之后无法重置 filter 问题
   7. 修复 select2 无法自动使用中文语言包问题 #839
   8. 修复表单勾选 继续创建 以及 继续编辑 跳转路由错误问题 #814
   9. 修复一对一关联关系 range 表单设置 rules 无效问题
   10. 修复当启用 fixColumns 时，时间筛选下拉会被遮挡问题 #833
   11. 修复菜单使用fa图标无法自动对齐问题 #758
   12. 修复表单 row 布局下使用 hasMany 提交报错问题 #801
   13. 修复表单 hasMany 无法使用 select 联动问题 #769

v2.0.11-beta

发布时间 2020/12/06

升级方法，逐步执行以下命令

composer remove dcat/laravel-admin
composer require dcat/laravel-admin:"2.0.11-beta"
php artisan admin:publish --assets --force
php artisan admin:publish --migrations --force # 表结构有变动
php artisan migrate

Bug修复

1. 修复使用 pjax 重复刷新页面可能导致 Dcat.init 监听失效问题
   2. 修复 admin:export-seed --users 会生成多余代码问题
   3. 修复表单编辑页面保存后跳转异常问题
   4. 修复表单页面选择继续编辑会导致 hasMany 重复添加数据问题
   5. 修复 select 表单联动后原 select2 config 丢失问题 #779
   6. 修复 map 表单加载异常问题 #764
   7. 修复批量删除功能删除数据后无法自动刷新页面问题
   8. 修复 hasMany 表单编辑页面无法正常展示 row 以及 column 布局问题
   9. 修复 Dcat.init 监听会被异步弹窗解绑问题
   10. 修复表格工具栏下拉菜单会被固定列表格遮挡问题 #728
   11. 修复禁用 showColumnSelector 时仍然会读取缓存内容问题

功能改进

1.Form::divider 增加 title 参数

增加 title 参数用于在分割线中间显示标题功能，用法

<?php

$form->divider('标题');

2.Grid::footer以及Grid::header调整为支持多次回调

<?php

$grid->header(...);

$grid->header(...);

$grid->header(...);

3.优化表格规格筛选器以及select表单样式

v2.0.10-beta

发布时间 2020/11/29

升级方法，逐步执行以下命令

composer remove dcat/laravel-admin
composer require dcat/laravel-admin:"2.0.10-beta"
php artisan admin:publish --assets --force
php artisan admin:publish --migrations --force # 表结构有变动
php artisan migrate

功能改进

1.增加表单右上角提示窗展示字段验证错误信息

此功能默认开启，可以通过validationErrorToastr方法禁用

<?php

$form->validationErrorToastr(false);

2.增加 Tree::maxDepth 方法用于限制模型树最大层级

<?php

$tree->maxDepth(5);

3.优化导出功能，支持标题设置关联关系字段以及自动读取grid表格列的标题

在当前版本中导出列默认与column列一致，不再需要手动设置导出的列名称以及翻译，并且支持关联关系字段

<?php

$grid->column('id');
$grid->column('name');
...

// 默认与上面的列相同
$grid->export();

4.工具表单增加resetButton与submitButton方法

<?php

// 禁用重置和提交按钮
$form->resetButton(false);
$form->submitButton(false);

5.表单字段的disable以及readOnly方法增加参数控制是否启用

<?php

// 传 false 则不启用
$form->text(...)->disable(false);

6.文件上传增加withDeleteData允许用户设置请求参数，并在上传接口以及删除接口中增加主键字段

通过 withDeleteData 方法可以传递自定义参数到文件删除接口

<?php

$form->file(...)->withDeleteData(['key' => 'value]);

7.增加embeds表单禁止显示标题功能` 第二个参数传false 则不显示标题

<?php

$form->embeds('field', false, function ($form) {
    ...
});

8.重新编写部分单元测试用例，以支持2.x用法

Bug修复

1. 修复管理员详情页无法选中已有权限问题
2. 修复 admin:export-seed 命令导出 seeder 类名异常问题
3. 修复表单删除跳转异常问题
4. 修复表单继续编辑跳转异常问题
5. 修复父表与 hasMany 存在同样字段名称时无法保存父表字段问题
6. 修复暗黑模式下选中子菜单样式异常问题 #712
7. 修复表单 block 布局下表单动态显示功能无效问题 #723
8. 优化 selectOptions 层级结构显示，解决前缀呈现随层级深度指数增加问题 #618
9. 修复 admin_view 没有返回数据问题
10. 修复 select 表单 ajax 以及 load 设置的链接不能带参数问题 #745
11. 修复表格行操作 action 的 handle 方法只能获取最后一行数据的 id 问题
12. 修复 list 表单编辑页无法删除已有数据问题 #759
13. 修复 embeds 范围表单 name 属性错误问题

功能改进

1.引入jquery.initialize组件，用于监听动态生成的页面元素并设置一个回调，下面来举一个简单的例子来演示用法：

在旧版本中，假如一个元素是JS动态生成的，如果我们需要对这个元素绑定一个点击事件的话，那么我们通常需要这么做

<div class="selector">test</div>

<script>
Dcat.ready(function () {
    // 需要先 off 再 on 否则页面刷新后会造成重复绑定问题
    $(document).off('click', '.selector').on('click', '.selector', function () {
        ...
    })
});
</script>

上面这种做法一来比较麻烦，需要先off再on；二来无法对动态生成的元素做一些特殊处理，例如你想在.selector生成后改变背景颜色，这个操作就没办法做到。

在这个版本中我们可以使用Dcat.init方法来监听元素动态生成，可以很方便的解决上面两个问题

<div class="selector">test</div>

<script>
Dcat.ready(function () {
    // $this 是当前元素的jquery dom对象
    // id 是当前元素的id属性，如果当前元素没有id则会自动生成一个随机id
    Dcat.init('.selector', function ($this, id) {
        // 修改元素的背景色
        $this.css({background: "#fff"});

        // 这里不需要 off 再重新 on，因为这个匿名函数只会执行一次
        $this.on('click', function () {
            ...
        });
    });
});
</script>

得益于这个jquery.initialize组件的引入，在当前这个版本中我们对表单组件的前端代码也进行了优化，使其更容易支持HasMany这种动态生成的表单类型，大大降低了代码的复杂性。

2.Form::hasMany以及Form::array表单支持column和row布局

如果字段比较多，可以用column和row布局以节省空间

<?php

$form->array('field', function (NestedForm $form) {
    $form->column(6, function (NestedForm $form) {
        $form->text('...');

        ...
    });

    $form->column(6, function (NestedForm $form) {
        ...
    });
});

3.配置过admin.auth.except参数的路由不需要验证权限 #673

4.Form、Grid以及Show字段类增加when方法

用法示例，类似Laravel QueryBuilder的when方法

在表格中

<?php

// 当第一个参数的值为 真 时才会执行闭包的代码
$grid->column('title')->when(true, function (Grid\Column $column, $value) {
    $column->label();
});

表单

<?php

// 当第一个参数的值为 真 时才会执行闭包的代码
$form->text('email')->when(true, function (Form\Field\Text $text, $value) {
    $text->type('email');
});

5.管理员模型增加canSeeMenu方法控制是否可见菜单

<?php

namespace App\Models;

use Dcat\Admin\Models\Administrator as Model;

class Administrator extends Model
{
    /**
     * 控制菜单是否可见，默认返回true
     * 
     * @param array|\Illuminate\Database\Eloquent\Model $menu 菜单节点
     * @return bool
     */
    public function canSeeMenu($menu)
    {
        return true;
    }
}

6.增加 admin_script、admin_style、admin_js、admin_css以及admin_require_assets函数

<?php

// 相当于 Admin::script
admin_script('console.log(xxx)');

// 相当于 Admin::style
admin_style('.my-class {color: red}');

// 相当于 Admin::js() 
admin_js(['@admin/xxx.js']);

// 相当于 Admin::css() 
admin_css(['@admin/xxx.css']);

// 相当于 Admin::requireAssets() 
admin_require_assets(['@select2']);

7.简化动作(Action)的JS代码逻辑，去除记住selector功能

BUG修复

1. 修复表格 orderable 功能异常问题 #674
2. 修复 JsonResponse methodIf 用法报错问题
3. 修复表格、表单以及数据详情指定 label #684
4. 修复表格 Grid::rows 回调无法正常使用问题
5. 修复widget添加JS代码异常导致部分类型的统计卡片异步加载功失效问题
6. 修复表格行操作 getKey 方法异常问题 #691
7. 修复当页面存在多个 select 表单时无法使用联动功能问题
8. 修复表格删除数据后无法自动刷新页面问题

v2.0.6-beta

发布时间 2020/11/7

升级方法，逐步执行以下命令

composer remove dcat/laravel-admin
composer require dcat/laravel-admin:"2.0.6-beta"
php artisan admin:publish --assets --force
php artisan admin:publish --migrations --force # 表结构有变动
php artisan migrate

功能接口破坏性变动

1.Form::tags表单默认保存为array类型

<?php

// 需要自己转换保存到数据库的格式
$form->tags('tag')->saveAsJson();

2.默认禁用 session 中间件

3.Form\Tree::disableFilterParents 重命名为 Form\Tree::exceptParentNode

<?php

$form->tree('cate')->exceptParentNode(false);

4.文件上传表单部分方法名称调整

// 启用分块上传功能 disableChunked 更改为 chunked$form->image('avatar')->chunked(true);

// 启用自动保存字段值功能 disableAutoSave 更改为 autoSave$form->image('avatar')->autoSave(false);

// 启用删除文件功能 disableRemove 更改为 removeable$form->image('avatar')->removeable(false);

功能改进

1.代码生成器增加字段拖动排序功能，此方法由小伙伴@codingyu贡献

2.菜单表增加show和extension字段，show字段用于控制是否显示菜单；extension字段用于标记是否为扩展菜单

3.Form::table、Form::array、Form::embeds表单支持关联关系字段

<?php

$form->table('profile.options', function ($form) {
         ...
});

4.增加 Form::checkbox 以及 Form::radio 表单选项竖排显示功能

<?php

$form->checkbox('xxx')->inline(false)->options([...]);

5.配置文件跳过登录以及权限验证功能允许配置路由别名

<?php

'auth' => [
     'except' => [ ... 'user.login', ],
],

6.Form\Row 增加 getKey 以及 model 方法

7.优化表格过滤器select表单选中效果，默认不选中

8.表单tab布局优化

BUG修复
1. 修复 Form::checkbox 选中/取消选中全部选项时动态显示表单功能无效问题
2. 修复台湾繁体无法翻译默认菜单标题问题
3. 修复 NestedForm 中的 number 字段输入值为 0 时会被过滤问题 #634
4. 修复模型树RowAction异步处理接口时获取主键报错问题
5. 修复表格过滤器无法重置关联表字段搜索值问题 #650
6. 修复表格过滤器multipleSelect表单异常问题

v2.0.5-beta

发布时间 2020/10/29

BUG修复

1. 修复表格搜索多个关联表字段sql错误问题 I232T7
2. 修复Form::datetimeRange表单无法选择日志问题
3. 修复无法添加多个Form::table表单字段问题 #627
4. 修复表格过滤器 MultipleSelectTable 中报错问题
5. 修复表格规格筛选器样式异常问题

v2.0.4-beta

发布时间 2020/10/27

BUG修复
1. 修复 admin_javascript_json 函数会自动空滤数组空值问题
2. 修复数据表单使用 tab 布局报错问题 #620
3. 修复扩展本地安装生成临时目录权限异常问题 #625
4. 修复表单使用 html 方法设置视图存在 script 标签时报错问题 #624
5. 修复数据详情使用关联关系（一对多）显示报错问题 #623
6. 修复 dropdown 下拉菜单计算显示位置异常问题 #I22S2N

v2.0.3-beta

发布时间 2020/10/27

BUG修复
1. 修复表单行内编辑显示返回信息异常问题
2. 修复admin.auth.remember设置无效问题 #613
3. 修复editor表单中文翻译异常问题 #611
4. 修复Filter::scope选择筛选项不会过滤分页参数问题
5. 修复表单事件拦截相关问题
6. 修复树形表单使用异常问题 #619

功能改进
1. 增加跳过权限和登录验证的配置方式
2. 扩展service provider增加middleware和路由排查注册功能
3. 批量操作change事件监听优化
4. 增加RowSelector健壮性, 以避免遇到json数组类型字段无法处理而报错 #609

v2.0.2-beta

发布时间 2020/10/21

BUG修复
1. 修复代码生成器生成控制器文件命名空间异常问题 #600
2. 修复配置文件logo路径错误问题
3. 修复表格关联字段搜索无效问题
4. 修复模型树行操作生成选择器重复问题
5. 修复访问无权限页面报错问题
6. 修复表格过滤器multipleSelect无法选中关联表字段值问题 #603
7. 修复表单tab布局无效问题 #605

功能改进
1. Auth\Permission移至Http目录
2. 数据表json字段改成text
3. 增加登录账号密码错误翻译
4. 增加 admin_javascript_json 函数，使大部分组件配置支持传递JS代码
5. Admin::color 增加暗黑模式颜色

v2.0.1-beta

发布时间 2020/10/20

BUG修复

• 修复数据表格过滤搜索BUG #599
• 修复代码生成器生成控制器基类命名空间错误问题 #600

功能改进

• 代码生成器增加页面标题以及面包屑翻译功能
• 异常处理优化
• 增加 admin_setting_array 函数