下面由laravel教程栏目给大家介绍dcat admin v2.0.0-beta 版本发布,希望对需要的朋友有所帮助!
dcat admin 是一个基于laravel-admin二次开发而成的后台构建工具,只需很少的代码即可构建出一个功能完善的高颜值后台系统。
前言
hi,各位同学大家好!时隔多日,dcat admin终于迎来了2.0的第一个版本,下面简单介绍一下主要变化,欢迎大家安装体验,如果有问题会即时修复~
安装
已发布 v2.0.1-beta 版本
composer require dcat/laravel-admin:v2.0.1-beta -vvv
有什么变化?
1.扩展
我们在这个版本中重点优化了 扩展 功能,主要简化了扩展的使用流程,让用户可以通过页面安装、卸载、升级扩展,并且同时支持了页面压缩包和composer两种安装方式。正式版发布时会上线应用市场功能,敬请期待~
详细使用文档即将在本周内逐步更新~
2.增强表单布局能力
在2.0中,我们对数据表单的block布局功能进行了重构,使其支持更复杂的布局,示例
$form->block(8, function (form\blockform $form) { $form->title('基本设置'); $form->showfooter(); $form->width(9, 2); $form->column(6, function (form\blockform $form) { $form->display('id'); $form->text('name'); $form->email('email'); $form->image('avatar'); $form->password('password'); }); $form->column(6, function (form\blockform $form) { $form->text('username'); $form->email('mobile'); $form->textarea('description'); });});$form->block(4, function (form\blockform $form) { $form->title('分块2'); $form->text('nickname'); $form->number('age'); $form->radio('status')->options(['1' => '默认', 2 => '冻结'])->default(1); $form->next(function (form\blockform $form) { $form->title('分块3'); $form->date('birthday'); $form->date('created_at'); });});
2.0也支持在tab布局中嵌套使用column和rows布局,如
这个功能同时支持数据表单和工具表单
$form->tab('标题', function (form $form) { $form->column(6, function (form $form) { ... }); $form->column(6, function (form $form) { ... });});
3.重构表单响应方法
在1.0版本中表单的响应方法只有success、error和redirect,无法满足一些比较复杂的场景,在2.0中我们让表单的响应方法和action的响应方法统一了起来,使其支持更多功能,并减少开发者的学习成本。
在数据表单中
$form->saving(function (form $form) { return $form ->response() ->success('保存成功') ->script('console.log("执行js代码")') ->redirect('auth/users');});
在工具表单中
public function handle(array $input){ ... return $this ->response() ->alert() ->success('成功') ->detail('详细内容');}
4.js 代码和 php 代码分离
这个功能是对laravel-admin2.0版本新特性的跟进,在2.0中更推荐把js代码放到视图文件中,示例
<style> .popover{z-index:29891015}</style><div class="{{$viewclass['form-group']}}"> <div for="{{ $id }}" class="{{$viewclass['label']}} control-label"> <span>{!! $label !!}</span> </div> <div class="{{$viewclass['field']}}"> @include('admin::form.error') <div class="input-group"> <span class="input-group-prepend"><span class="input-group-text bg-white" style="padding: 4px"><i style="width: 24px;height: 100%;background: {!! $value !!}"></i></span></span> <input {!! $attributes !!} /> @if ($append) <span class="input-group-append">{!! $append !!}</span> @endif </div> @include('admin::form.help-block') </div></div><script require="@color"> $('{{ $selector }}').colorpicker({!! json_encode($options) !!}).on('colorpickerchange', function(event) { $(this).parents('.input-group').find('.input-group-prepend i').css('background-color', event.color.tostring()); });</script>
<script> 和 <style> 标签中的代码,将会被提取编译,并实现 admin::script() 和 admin::style() 同样的处理效果,需要注意的是<script> 和 <style>必须是根标签,不能被包裹在其他标签中,否则会提取失败!
5.重构表格列选择器功能
在1.x中的列选择器中有一些兼容性问题,不能兼容一些特殊类型的表格,所以2.0中我们对列选择器功能进行了重构,并废弃了旧的api(responsive)。
新的列选择器功能可以完美兼容固定列和组合表头功能,并且支持记住用户操作功能,会自动记住用户的选择,效果如下
6.重构表格事件
在1.0表格的事件设计得比较随意、不规范,所以我们在2.0中对表格事件进行了重构,并增加了一些事件,新的表格事件用法如下
use dcat\admin\grid;grid::make(new model(), function (grid $grid) { $grid->listen(grid\events\fetching::class, function (grid $grid) { ... });});
如果你想监听所有的grid
use dcat\admin\grid;use illuminate\support\facades\event;event::listen(grid\events\fetching::class, function (grid $grid) { ...});// 或者grid::resolving(function (grid $grid) { $grid->listen(grid\events\fetching::class, function (grid $grid) { ... });});
关于事件的更多用法,请参考相关文档
7.表格行支持使用model
在2.0中如果grid表格使用的是model渲染数据,则可以在数据行相关回调中直接使用model的对象,如
$grid->clolumn('avatar')->display(function () { // getavatar是model中的自定义方法,这里可以直接调用 return $this->getavatar();});
8.重构模型树行操作
在2.0中我们对模型树的行操作功能进行了重构,新的行操作功能和数据表格的行操作功能用法一致
use dcat\admin\tree;$tree->actions(function (tree\actions $actions) { if ($actions->row->id > 5) { $actions->disabledelete(); // 禁用删除按钮 } // 添加新的action $actions->append(...);});// 批量添加action$tree->actions([ new action1(), "<div>...</div>", ...]);
9.增加settings配置表
在新版本中增加了settings配置表,目前主要用于保存扩展的启用和禁用配置数据,可以通过以下方式读写配置
// 读取admin_settings('key1', '默认值');admin_settings('arr.k1', '默认值');// 保存配置admin_settings([ 'key1' => ['v1'], 'arr.k1' => 'v1',]);
10.数据仓库接口重命名
在2.0中我们对数据仓库的接口命名做了简化处理,新的interface如下
interface repository{ /** * 获取主键名称. * * @return string */ public function getkeyname(); /** * 获取创建时间字段. * * @return string */ public function getcreatedatcolumn(); /** * 获取更新时间字段. * * @return string */ public function getupdatedatcolumn(); /** * 是否使用软删除. * * @return bool */ public function issoftdeletes(); /** * 获取grid表格数据. * * @param grid\model $model * * @return \illuminate\contracts\pagination\lengthawarepaginator|collection|array */ public function get(grid\model $model); /** * 获取编辑页面数据. * * @param form $form * * @return array|\illuminate\contracts\support\arrayable */ public function edit(form $form); /** * 获取详情页面数据. * * @param show $show * * @return array|\illuminate\contracts\support\arrayable */ public function detail(show $show); /** * 新增记录. * * @param form $form * * @return mixed */ public function store(form $form); /** * 查询更新前的行数据. * * @param form $form * * @return array|\illuminate\contracts\support\arrayable */ public function updating(form $form); /** * 更新数据. * * @param form $form * * @return bool */ public function update(form $form); /** * 删除数据. * * @param form $form * @param array $deletingdata * * @return mixed */ public function delete(form $form, array $deletingdata); /** * 查询删除前的行数据. * * @param form $form * * @return array|\illuminate\contracts\support\arrayable */ public function deleting(form $form);}
更多变动
控制器命名空间更新为dcat\admin\http\controllers废弃操作日志废弃分步表单(已开发成扩展 dcat-admin/form-step)语言包目录重命名(zh-cn更新为zh_cn)google字体本地化异常处理功能重构表单事件重构ui优化静态资源目录由vendors更改为vendor…我们在2.0中做了大量的细节改进,对许多功能接口都做了调整和代码优化,限于篇幅这里不再一一列出,详细说明会放在1.x升级指导文档中(文档即将在这几天内发布)。
关于应用市场和新主题
应用市场会在正式版发布时同步上线;
新主题会开发成插件,也会在正式版发布时同步上线~
以上就是全新扩展系统上线了!发布dcat admin v2.0.0-beta 版本~的详细内容。