跳到主要内容

FormItem 表单项 ​

WebH5

表单项。包裹一个表单控件,负责展示标签、必填星号与校验错误信息,并在控件 change/blur 时触发对应规则的校验。

何时使用 ​

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

何时不使用 ​

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

Props ​

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

Slots ​

名称说明
default一个表单控件(Input/Select/Checkbox/Switch/RadioGroup/Textarea 等)

示例 ​

基础(必填星号) ​

示例加载中…

标签 + 辅助控件 ​

示例加载中…

校验错误态(配合 Form) ​

示例加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 FormItem 文档(含手机预览)。