说明
FormRow 是纯排版容器:把相邻的几个 FormItem 放进同一行,按 Columns 等分成列(默认 2 列),行内间距由 grid-gap 统一控制,不再手写 display:grid 的临时样式。
常见能力:
- 默认两列等宽,
Columns可改成三列、四列 - 子
FormItem用Span跨列,适合地址、备注这类长字段 - 行内各项的下边距会被清零,垂直节奏交给行间距,不会出现双倍留白
- 窄屏(≤640px)整行堆叠为单列,跨列自动失效,输入框不会被挤窄
- 自身不参与校验,
Field/Form.Apply仍由内部FormItem负责
用法
<Form>
<FormRow>
<FormItem Label="姓名" Required="true">
<Input @bind-Value="name" />
</FormItem>
<FormItem Label="手机号">
<Input @bind-Value="phone" />
</FormItem>
</FormRow>
<FormRow Columns="3">
<FormItem Label="详细地址" Span="2">
<Input @bind-Value="address" />
</FormItem>
<FormItem Label="邮编">
<Input @bind-Value="zip" />
</FormItem>
</FormRow>
</Form>
跨列的项写在行首,占满连续几列;写在行中时,剩余列数不够会整项换到下一行。
API 参数
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Columns |
int |
2 |
列数。各项等宽;小于 1 时按 1 列处理。 |
ChildContent |
RenderFragment |
null |
行内的表单字段,通常为若干 FormItem。 |
Class |
string |
null |
附加 CSS 类名。 |
Style |
string |
null |
内联样式;会与内部注入的列数变量合并。 |
Visible |
bool |
true |
是否渲染整行。 |
FormItem 为配合布局新增:
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Span |
int |
0 |
跨列数,仅在 FormRow 内生效;0 或留空表示单列。 |
所有组件均继承
BaseComponent,除上表参数外还支持Class、Style、Disabled、Visible。
扫码关注公众号
扫码加入 QQ 群