FormItem 表单项
uni-appH5微信小程序App
表单字段包装器,提供标签、必填标记和校验错误展示。
何时使用
Form 内每个需要标签或校验的字段。
何时不使用
不需要标签与校验的独立控件直接用控件本身。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
label | string | "" | 标签文本 |
prop | string | - | 字段名,对应 Form model 的 key,支持嵌套路径:点路径(如 "user.name")与数组下标(如 "list[0].title");设置后才参与校验 |
required | boolean | false | 必填简写,仅展示红色 *(校验仍需 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>