第 04 章 后台表格与表单深度定制
4.1 表格组件 Table 基础
列表页由 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 搜索方式
| operate | 含义 |
LIKE | 模糊搜索(默认) |
= | 精确匹配 |
BETWEEN | 区间(常用于时间/数字) |
RANGE | 同区间,时间字段常用 |
false | 不开放搜索 |
常用 formatter
Table.api.formatter.image/images:缩略图Table.api.formatter.status:状态徽章(配合custom: {0:'danger',1:'success'})Table.api.formatter.datetime:时间戳格式化Table.api.formatter.toggle:状态开关(直接点击切换)
4.2 自定义表格按钮
在 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:新选项卡打开
4.3 表单定制
视图模板中使用 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)"
4.4 关联模型与 selectpage
控制器中定义关联后,列表可直接展示关联字段:
- 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 实现搜索式下拉选择分类。
4.5 控制器常用覆写
生成的控制器继承 Backend,可覆写:
index():列表查询条件、回收站(deletetime软删除)add()/edit():提交前数据处理_initialize():向视图统一下发枚举数据,如$this->view->assign('statusList', $this->model->getStatusList());
本章小结
表格靠 JS 列配置,表单靠模板与 Form.events,关联靠模型关联 + selectpage。掌握这三板斧可覆盖 90% 后台定制需求。下一章进入权限体系。