先说结论:
字段配置是生成器的核心配置环节之一。完成表格基础配置后,在这个页面可以为每个数据表字段绑定对应的表单组件、配置通用属性与专属参数,最终决定后台页面的表单交互效果。
这是系列第五篇,承接上一篇的表格创建,详细讲解字段配置页面的结构与操作方法。
点击 查看小泽代码在线演示
操作入口
菜单路径:小泽代码生成 → CRUD 表格 → 「字段」列表按钮 → 「添加」按钮
两种快速生成字段的方式
除了手动逐个添加字段,插件还支持两种批量生成字段的方式,适配不同场景:
- SQL 语句生成:点击「SQL 生成」按钮,粘贴 SQL 语句即可自动解析生成字段,适合统计页面、多表关联查询等场景。
- 数据表生成:点击「数据表生成」按钮,读取现有数据表的字段结构自动生成对应配置。该方式兼容 FastAdmin 官方常用字段后缀规则,可自动匹配对应组件,生成效果与官方 CRUD 的字段匹配逻辑相近。
页面整体结构
页面主要分为两大配置区域,分别管理通用属性与控件专属参数:
- 标签页配置区:包含「必要属性」「常见属性」「次要属性」3 个标签页,用于配置字段的通用基础属性,所有控件通用。
- 动态组件专属属性区:位于页面底部,会根据当前选择的「控件类型」动态加载对应配置项。例如选择下拉框时,会显示多选开关、数据源配置等专属项;选择普通文本框时则无额外专属配置。
填写提示
- 根据字段的业务含义,选择匹配的控件类型
- 若控件需要字典数据源(例如下拉选择性别),可选择对应字典项(如
sys_sex性别字典),使用前需先在数据字典中添加对应数据 - 选定控件类型后,可在三个标签页中按需填写通用属性,在页面底部配置该控件的专属参数
下面是一个开关按钮的填写情况:
下面是填写完成的列表:
CRUD代码生成插件 支持表单组件对照表
| 组件中文名称 | 组件标识 (widget) |
|---|---|
| 文本框 | input |
| 下拉框 | selectpicker |
| 动态下拉 (SelectPage) | selectpage |
| 单选框 | radio |
| 多选框 | checkbox |
| 开关按钮 | switch |
| 密码框 | password |
| 隐藏域 | hidden |
| 计数器 | counter |
| 文本域 | textarea |
| 富文本 | richtext |
| 穿梭框 | duallistbox |
| 标签(支持自动完成) | tagsinput |
| 排序号(weigh) | weigh |
| 分类树 | category |
| 自定义树(下拉分类树) | tree |
| 日期 (年月日) | date |
| 年 | year |
| 日期 (年月日时分秒) | datetime |
| 日期范围 | datetimerange |
| 时间(时分秒)(HH:mm:ss) | time |
| 创建时间(后端自动) | createtime |
| 修改时间(后端自动) | updatetime |
| 删除时间(后端自动) | deletetime |
| 图片上传 | picture |
| 文件上传 | file |
| 附件选择 | faselect |
| 图标 icon | icon |
| 颜色选择器 | colorpicker |
| 键值组件(商品 SKU) | fieldlist |
| 省市区联动 | citypicker |
| 评分(星级) | rating |
| 地图位置选择 | addresspicker |
| 进度条滑块 | slider |
| 用户选择 | admin |
| 登录用户(后端自动) | adminAuto |
| 部门选择 | department |
| 弹窗选择 | popup |
| 随机数 | random |
| 订单号(Luhn 算法) | orderno |
| 请求 IP | ip |
| 请求 URL | url |
| session 值 | sessionValue |
| 温馨提示 | alert |
| 分隔线 | hr |
| 它表字段 | otherTableField |
| 选择树(Checkbox Tree) | jstree |
完成字段与控件配置后,下一步即可配置业务方法与生成最终代码。下一篇会详细讲解业务方法的创建与配置。
演示地址:https://xzcurddemo.xiaozekeji.com/VRDJagoPKb.php 演示账号:demo / 123456
合规声明:本插件为基于 FastAdmin 框架的第三方插件,与 FastAdmin 官方无隶属、授权或认证关系;「小泽代码生成」为产品名称标识,尚未取得注册商标,不构成注册商标声明。