FormItem 表单项
WebH5
表单项。包裹一个表单控件,负责展示标签、必填星号与校验错误信息,并在控件 change/blur 时触发对应规则的校验。
何时使用
Form 内每个需要标签或校验的字段。
何时不使用
不需要标签与校验的独立控件直接用控件本身。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
label | string | "" | 标签文本 |
prop | string | - | 字段名,对应 Form model 的 key,支持嵌套路径:点路径(如 "user.name")与数组下标(如 "list[0].title");设置后才参与校验 |
required | boolean | false | 必填简写,仅展示红色 *(校验仍需 rules 中的 required 规则) |
Slots
| 名称 | 说明 |
|---|---|
default | 一个表单控件(Input/Select/Checkbox/Switch/RadioGroup/Textarea 等) |
示例
基础(必填星号)
示例加载中…
标签 + 辅助控件
示例加载中…
校验错误态(配合 Form)
示例加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 FormItem 文档(含手机预览)。