FormGroup

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

最后更新 2026-10-25 19:27:08

说明

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

常见能力：

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

参数	类型	默认值	说明
`ChildContent`	`RenderFragment`	`null`
`Error`	`string`	`null`	错误提示。直接给定即静态显示；留空时若配了 Field 且外层有 Form，则自动取用该字段的校验错误。
`Field`	`string`	`null`	字段名。置于 Form 内时用于就地取用/清除该字段的校验错误，并让本组在用户编辑时冒泡清掉红字。留空则不参与集中校验。
`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。