190 lines
4.1 KiB
Markdown
190 lines
4.1 KiB
Markdown
# 表单控件示例
|
|
|
|
> 基于 formDemo 的 Vue 3 表单控件使用指南
|
|
> 源码分析时间:2026-04-01
|
|
|
|
---
|
|
|
|
## 一、表单控件类型
|
|
|
|
| 示例 | 路径 | 控件类型 |
|
|
|------|------|----------|
|
|
| fieldForm1 | `formDemo/fieldForm1` | 文本、数值、日期 |
|
|
| fieldForm2 | `formDemo/fieldForm2` | 下拉、树形 |
|
|
| fieldForm3 | `formDemo/fieldForm3` | 弹窗选择 |
|
|
| fieldForm4 | `formDemo/fieldForm4` | 文件上传 |
|
|
| fieldForm5 | `formDemo/fieldForm5` | 开关、复选框 |
|
|
| fieldForm6 | `formDemo/fieldForm6` | 定位、地图 |
|
|
| verifyForm | `formDemo/verifyForm` | 表单验证 |
|
|
|
|
---
|
|
|
|
## 二、文本输入
|
|
|
|
```vue
|
|
<a-form-item label="普通文本框">
|
|
<a-input v-model:value="dataForm.CommonText" />
|
|
</a-form-item>
|
|
|
|
<a-form-item label="座机号码">
|
|
<a-input v-model:value="dataForm.TelePhone" />
|
|
</a-form-item>
|
|
```
|
|
|
|
---
|
|
|
|
## 三、数值输入
|
|
|
|
```vue
|
|
<!-- 普通数值 -->
|
|
<a-input-number v-model:value="dataForm.Natural" />
|
|
|
|
<!-- 带后缀 -->
|
|
<a-input-number v-model:value="dataForm.Reimbursement" addon-after="元" />
|
|
|
|
<!-- 带自定义按钮 -->
|
|
<a-input-number v-model:value="dataForm.ProductPrice">
|
|
<template #addonAfter>
|
|
<span @click="handleRandomValue">随机设定</span>
|
|
</template>
|
|
</a-input-number>
|
|
```
|
|
|
|
---
|
|
|
|
## 四、日期选择
|
|
|
|
```vue
|
|
<!-- 日期 -->
|
|
<jnpf-date-picker v-model:value="dataForm.ProductionDate" format="YYYY-MM-DD" />
|
|
|
|
<!-- 日期时间 -->
|
|
<jnpf-date-picker v-model:value="dataForm.ReturnMoneyDate" format="YYYY-MM-DD HH:mm:ss" />
|
|
|
|
<!-- 月份 -->
|
|
<jnpf-date-picker v-model:value="dataForm.StatisticalMonth" format="YYYY-MM" />
|
|
|
|
<!-- 日期范围 -->
|
|
<jnpf-date-range v-model:value="dataForm.Dates" format="YYYY-MM-DD HH:mm:ss" />
|
|
```
|
|
|
|
---
|
|
|
|
## 五、下拉选择
|
|
|
|
```vue
|
|
<a-select v-model:value="dataForm.category" placeholder="请选择">
|
|
<a-select-option value="1">选项1</a-select-option>
|
|
<a-select-option value="2">选项2</a-select-option>
|
|
</a-select>
|
|
|
|
<!-- 带搜索 -->
|
|
<a-select v-model:value="dataForm.category" show-search :filter-option="filterOption">
|
|
<a-select-option value="1">选项1</a-select-option>
|
|
</a-select>
|
|
```
|
|
|
|
---
|
|
|
|
## 六、文件上传
|
|
|
|
```vue
|
|
<a-upload :before-upload="beforeUpload" @change="handleChange">
|
|
<a-button>
|
|
<UploadOutlined /> 点击上传
|
|
</a-button>
|
|
</a-upload>
|
|
|
|
<script>
|
|
function beforeUpload(file) {
|
|
const isXls = file.type === 'application/vnd.ms-excel' || file.name.endsWith('.xlsx');
|
|
if (!isXls) {
|
|
createMessage.error('只能上传 Excel 文件');
|
|
}
|
|
return isXls;
|
|
}
|
|
</script>
|
|
```
|
|
|
|
---
|
|
|
|
## 七、开关和复选框
|
|
|
|
```vue
|
|
<!-- 开关 -->
|
|
<a-switch v-model:checked="dataForm.enabled" />
|
|
|
|
<!-- 单个复选框 -->
|
|
<a-checkbox v-model:checked="dataForm.agree">同意协议</a-checkbox>
|
|
|
|
<!-- 复选框组 -->
|
|
<a-checkbox-group v-model:value="dataForm.hobbies">
|
|
<a-checkbox value="1">读书</a-checkbox>
|
|
<a-checkbox value="2">运动</a-checkbox>
|
|
<a-checkbox value="3">旅游</a-checkbox>
|
|
</a-checkbox-group>
|
|
```
|
|
|
|
---
|
|
|
|
## 八、表单验证
|
|
|
|
```vue
|
|
<a-form ref="formRef" :model="dataForm" :rules="rules">
|
|
<a-form-item label="名称" name="name">
|
|
<a-input v-model:value="dataForm.name" />
|
|
</a-form-item>
|
|
</a-form>
|
|
|
|
<script setup>
|
|
const rules = {
|
|
name: [
|
|
{ required: true, message: '请输入名称', trigger: 'blur' },
|
|
{ min: 3, max: 20, message: '长度在 3-20 个字符', trigger: 'blur' }
|
|
],
|
|
email: [
|
|
{ required: true, message: '请输入邮箱', trigger: 'blur' },
|
|
{ type: 'email', message: '邮箱格式不正确', trigger: 'blur' }
|
|
]
|
|
};
|
|
</script>
|
|
```
|
|
|
|
---
|
|
|
|
## 九、表单布局
|
|
|
|
```vue
|
|
<a-form
|
|
ref="formRef"
|
|
:model="dataForm"
|
|
:label-col="{ style: { width: '110px' } }"
|
|
:colon="false"
|
|
>
|
|
<a-divider orientation="left">分组标题</a-divider>
|
|
|
|
<a-form-item label="字段1">
|
|
<a-input v-model:value="dataForm.field1" />
|
|
</a-form-item>
|
|
</a-form>
|
|
|
|
<style>
|
|
/* 固定宽度 */
|
|
.ant-input,
|
|
.ant-picker,
|
|
.ant-input-number {
|
|
width: 300px !important;
|
|
}
|
|
</style>
|
|
```
|
|
|
|
---
|
|
|
|
## 十、参考文件
|
|
|
|
| 文件 | 说明 |
|
|
|------|------|
|
|
| `formDemo/fieldForm1` | 文本、数值、日期 |
|
|
| `formDemo/fieldForm2` | 下拉、树形 |
|
|
| `formDemo/verifyForm` | 表单验证 |
|