跳到主要内容

FormItem 表单项 ​

uni-appH5微信小程序App

表单字段包装器,提供标签、必填标记和校验错误展示。

何时使用 ​

Form 内每个需要标签或校验的字段。

何时不使用 ​

不需要标签与校验的独立控件直接用控件本身。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
FormItem 表单项 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
labelstring""标签文本
propstring-字段名,对应 Form model 的 key,支持嵌套路径:点路径(如 "user.name")与数组下标(如 "list[0].title");设置后才参与校验
requiredbooleanfalse必填简写,仅展示红色 *(校验仍需 rules 中的 required 规则)

Slots ​

名称说明
default输入控件

示例 ​

必填星号 ​

vue
<Form :model="model">
  <FormItem label="手机号" prop="phone" required>
    <Input v-model="model.account" placeholder="用于接收通知" />
  </FormItem>
  <FormItem label="备注" prop="note">
    <Input v-model="model.password" placeholder="选填" />
  </FormItem>
</Form>

组合校验规则 ​

vue
<Form :model="reg" :rules="{ phone: [{ required: true, message: '请输入手机号' }] }">
  <FormItem label="手机号" prop="phone" required>
    <Input v-model="reg.phone" placeholder="用于登录" />
  </FormItem>
  <FormItem label="年龄" prop="age">
    <InputNumber v-model="reg.age" :min="1" :max="120" />
  </FormItem>
</Form>

搭配选择控件 ​

vue
<Form :model="info">
  <FormItem label="部门" prop="dept" required>
    <Select v-model="info.name" :options="options" placeholder="选择部门" />
  </FormItem>
  <FormItem label="邮箱" prop="email">
    <Input v-model="info.email" type="email" />
  </FormItem>
</Form>