# 字段控件映射 用户说「XX 字段」时,按下表直接落成控件 + 校验 + 列渲染,不用再问。 --- ## 一、类型对照表 | 用户说的类型 | 表单控件 | 必传属性 | 列表列 | |---|---|---|---| | 文本 / 名称 / 编码 | `` | `:maxlength="50"`、`autocomplete="off"`、`placeholder` | `ellipsis: true` | | 长文本 / 备注 / 描述 | `` | `:rows="3"`、`full`、`:maxlength="255"` | `ellipsis: true`,或不显示 | | 数字 / 排序 / 数量 | `` | `:precision="0"`、`:min="0"`、`style="width: 100%"` | `width: 80`、`align: 'center'` | | 金额 / 价格 | `` | `:precision="2"`、`:min="0"`、`:step="0.01"` | `width: 120`、`align: 'right'` | | 百分比 | `` | `:precision="2"`、`:min="0"`、`:max="100"` | `align: 'right'`,后缀 `%` | | 日期 | `` | `value-format="YYYY-MM-DD"`、`style="width: 100%"` | `width: 120`、`align: 'center'` | | 日期时间 | `` | `show-time`、`value-format="YYYY-MM-DD HH:mm:ss"` | `width: 180` | | 日期区间 | `` | `value-format="YYYY-MM-DD"`、`style="width: 100%"` | 拆成两个字段或 `ellipsis` | | 时间 | `` | `value-format="HH:mm:ss"` | `width: 100` | | 字典下拉 | `` + `mapByDictTypes` | `:allowClear`、`:showSearch`、`:filterOption="$utils.filterSelectOption"` | `template: true`,插槽里显示 `label` | | 固定枚举(2~4 个) | `` + 手写 `` | 同上 | `template: true`,配 `a-tag` | | 单选 / 是否 | `` | 选项 ≤ 4 个时用它,不用下拉 | `template: true`,显示文字 | | 开关 / 启用状态 | `` | `v-model:checked`,提交时转 `1 / 0` | `template: true`,配 `a-tag` | | 多选 | `` 或 `` | `:maxTagCount="3"` | 数组 `join('、')` | | 组织 / 校区 / 单位 | `` | `:treeCheckable="false"`、`:maxTagCount="1"`;带数据权限加 `:isDataScopeFilter="true"` | `ellipsis: true` | | 人员(单选) | `` | **必须** `:multiple="false"`(默认多选) | 显示姓名 | | 人员(多选) | `` | `:multiple="true"` | 姓名 `join('、')` | | 人员(按钮式) | `` | `buttonText`、`:multiple` | — | | 岗位 | `` | **必须**显式传 `:multiple` | 显示岗位名 | | 自定义树(分类 / 地区) | `` | `:recursionChildren`、`:props` | 显示名称 | | 附件 / 文件 | `` | `path`(业务表名)、`:maxFileCount`、`accept` | 显示「N 个附件」或图标 | | 图片 / 头像 | `` | `accept="image/*"`、`listType="card"`、`:maxFileCount="1"` | 缩略图插槽 | | 富文本 / 正文 | `` | `v-model`、`:config="{ minHeight: 300 }"`、`full` | 不显示或截断 | | 级联(省市区等) | `` | `:options` | `ellipsis: true` | | 密码 | `` | `:maxlength="32"`、`autocomplete="new-password"` | 不显示 | --- ## 二、校验规则模板 | 类型 | rules | |---|---| | 必填文本 | `{ required: true, message: '请输入名称', trigger: 'blur' }` | | 限长 | `{ max: 50, message: '最多 50 个字符', trigger: 'blur' }` | | 必选(下拉 / 日期 / 树 / 选人) | `{ required: true, message: '请选择状态', trigger: 'change' }` | | 手机号 | `{ pattern: /^1[3-9]\d{9}$/, message: '手机号格式不正确', trigger: 'blur' }` | | 邮箱 | `{ type: 'email', message: '邮箱格式不正确', trigger: 'blur' }` | | 正整数 | 自定义 validator,见 `03-组件文档-表单与弹窗.md` | | 数字范围 | `{ type: 'number', min: 0, max: 999999, message: '超出范围', trigger: 'blur' }` | 文案规则:输入类 `请输入XX`,选择类 `请选择XX`,与 `label` 保持一致。 --- ## 三、列配置速查 ```js const columns = ref([ { title: '名称', dataIndex: 'name', ellipsis: true, template: true }, // 需要自定义渲染才加 template { title: '编码', dataIndex: 'code', ellipsis: true }, { title: '状态', dataIndex: 'status', width: 100, align: 'center', template: true }, { title: '创建时间', dataIndex: 'createTime', width: 180, align: 'center' }, { title: '操作', dataIndex: 'action', width: 160, align: 'center', fixed: 'right' } ]) ``` - `template: true` → 必须配同名插槽 `