表单

表单布局

配置表单中表单项的标签与输入区的布局方式，当表单和表单项设置不同的布局方式时，以表单项的设置为准。支持上下布局和左右布局。

标签宽度

以百分比方式配置表单中标签的宽度。
仅表单布局方式为左右布局时，支持此配置项。

宽度

配置表单组件的宽度值，支持以下宽度设置方式：

• 固定：固定的像素值，不会随容器大小变化。
• 百分比：元素的宽度占容器宽度的百分比。
• 填充容器：元素的宽度填满容器的可用空间。
• 适应内容：元素的宽度会随着内容的大小自动调整。

高度

配置表单组件的高度值，支持以下高度设置方式：

• 固定：固定的像素值，不会随容器大小变化。
• 百分比：元素的高度占容器高度的百分比。
• 填充容器：元素的高度填满容器的可用空间。
• 适应内容：元素的高度会随着内容的大小自动调整。

尺寸限制

配置表单组件的尺寸限制，支持配置最大高度、最小高度、最大宽度、最小宽度。
合理设置尺寸限制参数可以确保组件在不同屏幕尺寸下保持布局的稳定性和一致性，避免因屏幕尺寸差异而导致的布局问题。

最小高度

配置表单组件的最小高度，默认值为 168px。

排列方向

配置表单组件的排列方向，支持纵向、横向、换行。

元素间距

配置表单组件中各元素的间距，支持自动和固定间距。

间距

当配置固定间距时，设置间距值。

元素分布

配置表单组件中的元素的分布方式。

填充

配置表单组件背景的显示颜色。

圆角

配置表单组件背景的圆角，支持单独设置四个角的圆角。

内边距

配置表单组件背景的内边距，可以单独设置四个方向的内边距。

外边距

配置表单组件背景的外边距，可以单独设置四个方向的外边距。

边框

配置表单组件背景的边框样式。支持如下设置方式：

• 预设样式：提供预设的边框样式，可直接使用。
• 自定义样式：通过边框线的颜色、粗细和样式，自定义边框样式。

阴影

配置表单组件背景的阴影样式，增强组件的立体感。支持如下设置方式：

• 预设样式：提供预设的阴影样式，可直接使用。
• 自定义样式：支持通过样式、X偏移、Y偏移、模糊半径、扩展半径、颜色，自定义阴影样式。

图层模糊

配置表单组件的模糊效果。数值越大，模糊效果越明显。

溢出

配置表单组件溢出相关设置，支持以下溢出方式：

• 滚动：添加滚动条以查看超出的内容。
• 可见：显示全部内容。
• 隐藏：隐藏超出容器的内容。

缩放

配置表单组件大小的缩放比例。

旋转

配置表单组件围绕中心点旋转的角度。

位移

配置表单组件在水平和垂直方向上的移动距离。

倾斜

配置表单组件在水平和垂直方向上的倾斜角度。

禁用态

配置表单组件的禁用状态。具体配置说明如下：

• 设置为 true：组件处于禁用状态。
• 设置为 false：组件处于可用状态。
• 设置为变量：通过变量值（true 或 false）动态控制表单组件的禁用状态。
  例如可以通过工作流控制表单组件的禁用状态。工作流为 example_workflow，当你将表单组件中的插槽部分禁用态设置为{{example_workflow.disable.value}}后，当工作流的 disable 属性为 true 时，{{example_workflow.disable.value}} 值为 true，表单组件将处于禁用状态。

加载态

配置表单组件的加载状态。具体配置说明如下：

• 设置为 true：组件展示加载状态，隐藏组件内容。
• 设置为 false：关闭加载状态。
• 设置为变量：通过变量值（true 或 false）动态控制表单组件的加载状态。
  例如可以通过单行输入组件控制表单组件的加载状态。单行输入组件 ID 为 Input1，当你将表单组件中插槽部分的加载态设置为{{Input1.value}}后，在单行输入组件中输入文本时，{{Input1.value}}值为 true，表单组件展示加载态。

点击效果

配置表单组件的点击态效果。具体配置说明如下：

• 样式效果：点击表单组件时，表单组件的样式变化情况。详细说明，请参考样式设置。
• 变换效果：点击表单组件时，表单组件的动态变化情况。详细说明，请参考变换设置。
• 过渡效果：设置表单组件点击态的动画效果。
  • 动画效果：支持设置为缓入缓出、缓入、缓出、线性等动画。
  • 持续时间：设置动画的持续时间，单位为毫秒。
  • 延迟时间：设置动画延迟出现的时间，单位为毫秒。
  • 生效范围：设置动画的生效范围。
    • 应用于全部变化：动画效果将应用于样式设置和变换设置所产生的所有变化。
    • 仅应用于变换效果：动画效果仅应用于变换设置所产生的变化。

出场效果

设置表单组件在界面中出现时的动画效果。目前支持设置为淡入、缩放、模糊、水平翻转、垂直翻转、从下滑入、从上滑入、从左滑入、从右滑入等动画效果。

事件类型

支持以下事件类型：

• 提交时：当表单提交时触发。
• 提交失败时：当表单提交失败时触发。
• 数据改变时：当表单内的内容改变时触发。

组件方法

支持以下方法：

• 设置数据：为组件设置或更新内容。
• 设置禁用：使组件变为禁用状态，用户无法与之交互。
• 提交：提交组件数据。
• 设置隐藏：隐藏组件，使其不可见。
• 设置加载：使组件变为加载状态，用户无法与之交互。
• 复制到剪贴板：复制文本内容到剪切板。
• 清除：清除组件的内容，例如文本输入框中的文字。