feat: initial commit
This commit is contained in:
commit
539b115e38
232 files changed
+31223
No files matched your search
@@ -0,0 +1,189 @@
|
||||
# 表单控件示例
|
||||
|
||||
> 基于 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` | 表单验证 |
|
||||
Reference in new issue
Block a user