4.1 KiB
4.1 KiB
表单控件示例
基于 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 |
表单验证 |
二、文本输入
<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>
三、数值输入
<!-- 普通数值 -->
<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>
四、日期选择
<!-- 日期 -->
<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" />
五、下拉选择
<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>
六、文件上传
<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>
七、开关和复选框
<!-- 开关 -->
<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>
八、表单验证
<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>
九、表单布局
<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 |
表单验证 |