FormItem

统一的标签、必填标记、错误与帮助信息容器。

最后更新

说明

所有输入类组件建议包在 FormItem 内,以保证表单排版与校验提示一致。置于 Form 内并标注 Field 时,可自动就地显示该字段的校验错误、编辑时自动清除。

常见能力:

  • 标签与图标
  • 必填标记
  • 帮助提示(标签末尾问号图标,悬停 / 聚焦出气泡,不占纵向空间)
  • 错误文字
  • 隐藏标签
  • 配合 Form 行内校验

用法

<FormItem Label="用户名" Required="true" Help="登录时使用">
    <Input @bind-Value="@user" />
</FormItem>

API 参数

参数 类型 默认值 说明
ChildContent RenderFragment null
Error string null 错误提示。直接给定即静态显示;留空时若配了 Field 且外层有 Form,则自动取用该字段的校验错误。
Field string null 字段名。置于 Form 内时用于就地取用/清除该字段的校验错误,并让本组在用户编辑时冒泡清掉红字;同时把 Label 与 Required 登记给 Form.Validate(),作为提交前必填校验的依据。留空则不参与集中校验。
For string null 关联控件的 id。
Help string null 帮助文字。渲染为标签末尾的问号图标,悬停 / 键盘聚焦时气泡展示,不占控件下方的纵向空间;经本地化后按内联 HTML 渲染,可写 等标签强调,气泡自动换行。气泡统一向上弹开、不挡正在填写的控件;弹窗 / 视口顶部放不下时翻到标签下方,贴边时自动平移进可视区;关闭态气泡不占滚动区,弹窗不会凭空多出滚动条。
Icon string null 标签前置图标。
Label string null 标签。
LabelHidden bool false 隐藏标签但保留占位。
Required bool false 必填(标签后加 *)。
Visible bool true 取得或设置组件是否可见,默认为false。
VisibleChanged EventCallback<bool> — 事件 取得或设置组件可见性变化时的回调事件。
Class string null 取得或设置组件的CSS类名,用于自定义样式。
Disabled bool false 取得或设置组件是否禁用,默认为false。
Style string null 取得或设置组件的内联样式,用于自定义样式。

所有组件均继承 BaseComponent,除上表参数外还支持 Class、Style、Disabled、Visible。

微信公众号二维码 扫码关注公众号
QQ 交流群二维码 扫码加入 QQ 群