自定义业务逻辑

📖 组件文档请查看 amis ~
🫣 框架论坛

方法重写

在 Slowlyo\SlowAdmin\Controllers\AdminController 中已经实现了以下方法:

就是 resource 路由对应的那几个方法, 如果你还不知道请看 文档

当默认的方法不满足你的需求时, 可以在你的 controller 重写这几个方法

Controller

以角色管理控制器举例

<?php

namespace Slowlyo\SlowAdmin\Controllers;

use ...;

class AdminRoleController extends AdminController
{
    // 功能对应的Service
    // 作用: 在 AdminController 中用于实现基础的 CRUD
    protected string $serviceName = AdminRoleService::class;

    // 该方法实现了列表页的显示, 以及获取列表数据
    public function index(Request $request): JsonResponse|JsonResource
    {
        // 返回列表数据
        if ($this->actionOfGetData()) {
            return $this->response()->success($this->service->list());
        }

        // 返回页面结构
        return $this->response()->success($this->list());
    }

    // 列表页的页面结构
    public function list(): Page
    {
        // ->baseCRUD() 在AdminController 中
        // 对一些基础的页面配置作了封装
        $crud = $this->baseCRUD()
            // 假如你想单独设置列表页的标题
            // 可以在此处再次调用 ->title() 方法, 他会覆盖 baseCRUD() 中的设置
            // ->title('Title')

            // 是否展示筛选折叠按钮
            ->filterTogglable(false)
            // 列表筛选部分表单
            ->filter($this->baseFilter()->body([
                // 内容就是 Form 的 body 属性
                // 数据筛选的查询需要在 listQuery() 方法中自行实现
                InputText::make()->name('name')->label('名称')
            ]))
            // 这是数据列
            ->columns([
                Column::make()->label('ID')->name('id')->sortable(true),
                Column::make()->label('名称')->name('name'),
                Column::make()->label('标识')->name('slug')->type('tag'),
                Column::make()->label('创建时间')->name('created_at')->type('datetime')->sortable(true),
                Column::make()->label('更新时间')->name('updated_at')->type('datetime')->sortable(true),
                // 这个方法会添加操作列
                // 默认会生成 ->rowActions()
                $this->rowActionsOnlyEditAndDelete(),
            ]);

        // baseList() 封装了基础的 Page 以及默认的新增按钮
        return $this->baseList($crud);
    }

    // 表单页面结构 (新增/编辑)
    public function form($isEdit): Form
    {
        return $this->baseForm()->body([
            InputText::make()->label('名称')->name('name')->required(true),
            InputText::make()->label('标识')->name('slug')->description('角色的唯一标识, 不可重复')->required(true),
            TreeSelect::make()
                ->name('permissions')
                ->label('权限')
                ->searchable(true)
                ->multiple(true)
                ->options(AdminPermissionService::make()->getTree())
                ->labelField('name')
                ->valueField('id')
                ->autoCheckChildren(false)
                ->joinValues(false)
                ->extractValue(true),
        ]);
    }

    // 详情页面结构
    public function detail(): Form
    {
        return $this->baseDetail()->body([]);
    }
}

Service

以角色 Service 举例

<?php

namespace Slowlyo\SlowAdmin\Services;

use ...;

class AdminRoleService extends AdminService
{
    // 功能对应的 Model
    protected string $modelName = AdminRole::class;

    // 几乎所有的数据库操作都在 Service 中
    // 不满足的地方, 在此处重写即可

    // 列表/导出数据查询
    public function listQuery()

    // 列表数据
    public function list()

    // 详情获取数据
    public function getDetail($id)

    // 编辑获取数据
    public function getEditData($id)

    // 修改保存
    public function update($id, $data)

    // 新增保存
    public function store($data)

    // 删除
    public function delete($ids)
}

😏建议在使用前通读并背诵相关文档: laravel 、amis ~

❓常见问题参见 FAQ