组件功能
Form 是表单容器组件,用于包裹表单控件并处理提交事件。
它继承了 Box 组件的布局能力,同时支持定义表单提交动作。
基础用法
通过 direction 控制子组件的排列方向,通过 children 定义表单内的控件,gap 用于设置子元素之间的间距。
下面示例展示了一个用户登录表单,包括用户名和密码输入框,以及提交按钮。
Template 示例:
<Formdirection="col"gap="16px"onSubmitAction={{ type: "submit_form", payload: { formId: "user-form" } }}><Input name="username" placeholder="用户名" /><Input name="password" inputType="password" placeholder="密码" /><Button label="提交" submit={true} /></Form>
效果展示如下:


属性说明
表单属性
属性名 | 类型 | 描述 | 默认值 |
onSubmitAction | ActionConfig | 表单提交时触发的动作 | - |
布局属性
属性名 | 类型 | 描述 | 默认值 |
direction | "row" | "col" | 布局方向 | "col" |
children | ChatKitComponent[] | 子组件列表 | - |
align | Alignment | 交叉轴对齐方式 | - |
justify | Justification | 主轴对齐方式 | - |
wrap | "nowrap" | "wrap" | "wrap-reverse" | 换行方式 | "nowrap" |
flex | number | string | Flex 值 | - |
gap | number | string | 子元素间距 | - |
padding | number | string | Spacing | 内边距 | - |
border | number | Border | Borders | 边框配置 | - |
background | string | ThemeColor | 背景颜色 | - |
尺寸属性
属性名 | 类型 | 描述 | 默认值 |
height | number | string | 高度 | - |
width | number | string | 宽度 | - |
size | number | string | 同时设置宽高 | - |
minHeight | number | string | 最小高度 | - |
minWidth | number | string | 最小宽度 | - |
minSize | number | string | 最小尺寸 | - |
maxHeight | number | string | 最大高度 | - |
maxWidth | number | string | 最大宽度 | - |
maxSize | number | string | 最大尺寸 | - |
aspectRatio | number | string | 宽高比 | - |
radius | RadiusValue | 圆角 | - |
margin | number | string | Spacing | 外边距 | - |