显示页面讨论过去修订反向链接回到顶部 本页面只读。您可以查看源文件,但不能更改它。如果您觉得这是系统错误,请联系管理员。 # 第 04 章 后台表格与表单深度定制 ## 4.1 表格组件 Table 基础 列表页由 `public/assets/js/backend/xxx.js` 驱动,核心是 `Table.api.init`: ```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 列添加按钮数组: ```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` 绑定的组件: ```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`: ```html data-rule="required;length(2~50)" ``` ## 4.4 关联模型与 selectpage 控制器中定义关联后,列表可直接展示关联字段: ```php // model/Article.php public function category() { return $this->belongsTo('Category', 'category_id', [], [], 'LEFT')->setEagerlyType(0); } ``` JS 列配置: ```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% 后台定制需求。下一章进入权限体系。 登录 Detach Close 该主题尚不存在 您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。 fastadmin/后台表格与表单深度定制.txt 最后更改: 2026/08/19 11:33由 张叶安 登录