fastadmin:后台表格与表单深度定制

第 04 章 后台表格与表单深度定制

列表页由 public/assets/js/backend/xxx.js 驱动,核心是 Table.api.init:

snippet.js
table.bootstrapTable({
    url: 'article/index',
    pk: 'id',
    sortName: 'weigh',
    columns: [[
        {checkbox: true},
        {field: 'id', title: 'ID', sortable: true},
        {field: 'title', title: '标题', operate: 'LIKE'},
        {field: 'status', title: '状态', formatter: Table.api.formatter.status},
        {field: 'createtime', title: '创建时间', formatter: Table.api.formatter.datetime},
        {field: 'operate', title: '操作', table: table, events: Table.api.events.operate,
         formatter: Table.api.formatter.operate}
    ]]
});
operate 含义
LIKE 模糊搜索(默认)
= 精确匹配
BETWEEN 区间(常用于时间/数字)
RANGE 同区间,时间字段常用
false 不开放搜索
  • Table.api.formatter.image / images:缩略图
  • Table.api.formatter.status:状态徽章(配合 custom: {0:'danger',1:'success'})
  • Table.api.formatter.datetime:时间戳格式化
  • Table.api.formatter.toggle:状态开关(直接点击切换)

在 operate 列添加按钮数组:

snippet.js
{
    name: 'detail', text: '详情', title: '查看详情',
    classname: 'btn btn-xs btn-primary btn-dialog',
    icon: 'fa fa-list', url: 'article/detail'
}

按钮类型常用 classname:

  • btn-dialog:弹窗打开
  • btn-ajax:AJAX 请求(常用于审核、推送)
  • btn-addtabs:新选项卡打开

视图模板中使用 Form.events 绑定的组件:

snippet.html
<div class="form-group">
    <label class="control-label col-xs-12 col-sm-2">封面图:</label>
    <div class="col-xs-12 col-sm-8">
        <input id="c-image" data-rule="required" class="form-control"
               name="row[image]" type="text" value="{$row.image|htmlentities}">
        <!-- 上传按钮由 data 属性与 plupload 组件自动接管 -->
    </div>
</div>
控件 用法
单图上传 class="form-control" + id 约定,JS 中 Form.events.plupload
富文本 class="form-control editor" + Form.events.editor
日期时间 class="form-control datetimepicker" + data-date-format
联动下拉 data-toggle="selectpage" + data-source="category/index"
动态字段 data-toggle="fieldlist" 键值对编辑器

在 input 上加 data-rule:

snippet.html
data-rule="required;length(2~50)"

控制器中定义关联后,列表可直接展示关联字段:

snippet.php
// model/Article.php
public function category()
{
    return $this->belongsTo('Category', 'category_id', [], [], 'LEFT')->setEagerlyType(0);
}

JS 列配置:

snippet.js
{field: 'category.name', title: '分类'}

表单中使用 selectpage 实现搜索式下拉选择分类。

生成的控制器继承 Backend,可覆写:

  • index():列表查询条件、回收站(deletetime 软删除)
  • add() / edit():提交前数据处理
  • _initialize():向视图统一下发枚举数据,如 $this->view->assign('statusList', $this->model->getStatusList());

表格靠 JS 列配置,表单靠模板与 Form.events,关联靠模型关联 + selectpage。掌握这三板斧可覆盖 90% 后台定制需求。下一章进入权限体系。

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • fastadmin/后台表格与表单深度定制.txt
  • 最后更改: 2026/08/19 11:33
  • 由 张叶安