开发前必读

<?php use Illuminate\Contracts\Support\Renderable; use Dcat\Admin\Admin; class Card implements Renderable { public static $js = [ // js脚本不能直接包含初始化操作，否则页面刷新后无效 'xxx/js/card.min.js', ]; public static $css = [ 'xxx/css/card.min.css', ]; public function script() { return <<<JS console.log('所有JS脚本都加载完了'); // 初始化操作 $('xxx').card(); JS; } public function render() { // 在这里可以引入你的js或css文件 Admin::js(static::$js); Admin::css(static::$css); // 需要在页面执行的JS代码，例如初始化代码 // 通过 Admin::script 设置的JS代码会自动在所有JS脚本都加载完毕后执行 Admin::script($this->script()); return view('...')->render(); } }

use Dcat\Admin\Layout\Content; use Card; class HomeController { public function index(Content $content) { // 使用上面的Card组件 // Card组件需要用到的静态文件只会在当前请求加载 // 其他请求不会加载 return $content->body(new Card()); } }

<?php use Dcat\Admin\Admin; use Dcat\Admin\Layout\Content; class UserController { public function index(Content $content) { Admin::script( <<<JS (function () { // 如果有定义局部变量的需求，最好放在匿名函数内，防止变量污染 var name = 'test'; console.log('所有JS脚本都加载完毕啦~~', name) })() JS ); return $content->header(...)->body(...); } }

<script> // 用 Dcat.ready() 代替 $() // 此方法会在所有 js 脚本加载完成后执行 Dcat.ready(function () { // 写入你的 js 代码 console.log('所有 js 脚本加载完毕啦~~'); }); </script>

use Dcat\Admin\Layout\Content; public function index(Content $content) { // 选填 $content->header('填写页面头标题'); // 选填 $content->description('填写页面描述小标题'); // 添加面包屑导航 $content->breadcrumb( ['text' => '首页', 'url' => '/admin'], ['text' => '用户管理', 'url' => '/admin/users'], ['text' => '编辑用户'] ); // 填充页面body部分，这里可以填入任何可被渲染的对象 return $content->body('hello world'); }

use App\Admin\Repositories\User; use Dcat\Admin\Form; use Dcat\Admin\Grid; use Dcat\Admin\Show; use Dcat\Admin\Http\Controllers\AdminController; class UserController extends AdminController { // 数据表格 protected function grid() { return Grid::make(new User(), function (Grid $grid) { ... }); } // 数据详情 protected function detail($id) { return Show::make($id, new User(), function (Show $show) { ... }); } // 表单 protected function form() { return Form::make(new User(), function (Form $form) { ... }); } }

<?php namespace Dcat\Admin\Controllers; use Dcat\Admin\Layout\Content; use Illuminate\Routing\Controller; class AdminController extends Controller { // 页面标题 protected $title; // 页面描述信息 protected $description = [ // 'index' => 'Index', // 'show' => 'Show', // 'edit' => 'Edit', // 'create' => 'Create', ]; // 指定语言包名称，默认与当前控制器名称相对应 protected $translation; // 返回页面标题 protected function title() { return $this->title ?: admin_trans_label(); } // 返回描述信息 protected function description() { return $this->description; } // 列表页 public function index(Content $content) { return $content ->title($this->title()) ->description($this->description()['index'] ?? trans('admin.list')) ->body($this->grid()); } // 详情页 public function show($id, Content $content) { return $content ->title($this->title()) ->description($this->description()['show'] ?? trans('admin.show')) ->body($this->detail($id)); } // 编辑页 public function edit($id, Content $content) { return $content ->title($this->title()) ->description($this->description()['edit'] ?? trans('admin.edit')) ->body($this->form()->edit($id)); } // 新增页 public function create(Content $content) { return $content ->title($this->title()) ->description($this->description()['create'] ?? trans('admin.create')) ->body($this->form()); } // 修改接口 public function update($id) { return $this->form()->update($id); } // 新增接口 public function store() { return $this->form()->store(); } // 删除/批量删除接口 public function destroy($id) { return $this->form()->destroy($id); } }

use App\Admin\Metrics\Examples\NewDevices; use App\Admin\Metrics\Examples\NewUsers; use App\Admin\Metrics\Examples\TotalUsers; use Dcat\Admin\Layout\Content; use Dcat\Admin\Layout\Row; public function index(Content $content) { return $content ->title($this->title()) ->description($this->description()['index'] ?? trans('admin.list')) ->body(function (Row $row) { $row->column(4, new TotalUsers()); $row->column(4, new NewUsers()); $row->column(4, new NewDevices()); }) ->body($this->grid()); }