FormRow

把一组表单字段排成等分列的行,子项用 Span 跨列,窄屏自动堆叠。

最后更新

说明

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 交流群二维码 扫码加入 QQ 群