Files
aibridge/docs/codedev/07-form-examples.md
2026-05-18 09:28:15 +08:00

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 表单验证