首先声明,我认为Laravel-admin经过多次打造,已经是一款很不错的产品,但是这不能掩盖它文档不全的事实。Laravel-admin的文档是去年开始补充的,但是仍有一些地方没有提及或者没有详细说明,为了开发方便,在此做一个补充,也是给自己做个备份。当然,本文提及的补充说明,可能在某个时间后官方就补充到文档中了,但是仍然可以查阅本文来快速解惑。
前端组件
表单
文档中提及了大部分的用法,不过没有提及如何预置/填充数据,如果查看源码,就会发现有一个fill方法可以填充数据,这在不使用Model的情况下,可以快速的把自己读取到的数据填充到表单中,而不用一个一个设置默认值,pretty nice!它的用法很简单,参数传键值对数组进去。
更新:文档中提及构造函数可以传入数据,跟fill用法一致。
模型表单
表单脚部(Footer)
文档里有常用的方法,但是有几个实用的方法没有列出来,在此补充:
$form->footer(function (Form\Footer $footer) {
// 默认勾选`查看`
$footer->checkView();
// 默认勾选`继续创建`
$footer->checkCreating();
// 默认勾选`继续编辑`
$footer->checkEditing();
});
其他的方法也可以去Encore\Admin\Form\Footer里面看
控制台命令
admin:export-seed
这个命令官方没有重点介绍,其实这是一个非常实用的导出命令,可以导出我们在数据库设置的管理员、角色、权限、菜单到Seeder文件中,一般用于团队间同步这些数据,也可以作为项目部署的一部分。
用法很简单,直接执行 php artisan admin:export-seed 就好了,默认导出角色、权限、菜单到AdminTablesSeeder.php。如果想指定文件的名字,可以在后面直接加上,比如 php artisan admin:export-seed AdminTablesSeeder;如果想导出管理员,加上参数--users;如果想排除某些字段,使用参数--except-fields,默认为id,created_at,updated_at。