文本输入

标签

配置是否显示文本输入组件的标签，标签可以为文本输入组件提供文字描述，使用户能够更直观地理解文本输入组件的状态或功能。

标签内容

配置文本输入组件的标签内容，支持配置静态内容和动态绑定数据，详情请参见设置组件内容参数。
仅打开了文本输入组件的设置开关时，才支持此配置项。默认标签内容为请输入文本。

是否必填

配置文本输入是否为必填项。
例如在表单填报场景中，当开启“是否必填”开关时，文本输入字段会被标记为必填项。用户在提交表单之前必须输入一些文本，否则表单将不允许提交。

占位文案

配置文本输入的占位文案，占位文案是一种提示性文本，它出现在输入字段中但不会显示在最终提交的数据里。
默认为请输入内容。

字符上限

配置文本输入组件的字符上限，字符上限是一个限制用户在文本输入框中可以输入的最大字符数的功能。默认关闭字符上限，你可以打开开关，并根据实际需求设置字符上限数值。

默认值

配置文本输入组件的默认值。

组件布局

配置标签与输入框的布局方式，支持上下布局和左右布局。

垂直对齐

配置文本输入组件的垂直对齐方式。

• 范围：顶部对齐、垂直居中对齐、底部对齐。
• 默认值：顶部对齐。

禁用态

可控制文本输入组件在什么情况下展示禁用状态。

• 表达式的结果为 true：文本输入呈禁用态。
• 表达式的结果为 false：文本输入呈可用态。

例如，通过一个开关组件来控制此组件是否禁用，可以将表达式设置为{{Switch1.value}}，当打开开关组件时，{{Switch1.value}}为true，此组件呈禁用态；当关闭开关组件时，{{Switch1.value}}为false，此组件呈可用态。

加载态

可控制文本输入组件在什么情况下展示加载状态。

• 表达式的结果为 true：文本输入呈加载态。
• 表达式的结果为 false：文本输入呈可用态。

例如，希望工作流在执行过程中，此组件呈加载状态，则可以在输入框中输入{{Workflow1.loading}}。注意，loading是数据源的一个状态，数据源的loading在请求过程中为true，在请求未开始或结束时为false。

宽度

配置文本输入组件的宽度值，支持以下宽度设置方式：

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

高度

配置文本输入组件的高度值，支持以下高度设置方式：

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

尺寸限制

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

填充

配置文本输入组件背景的显示颜色。

圆角

配置文本输入组件背景的圆角，支持单独设置四个角的圆角。

内边距

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

外边距

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

边框

配置文本输入组件背景的边框样式。支持如下设置方式：

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

阴影

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

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

模糊

配置文本输入组件的模糊效果，数值越大，模糊效果越明显。支持设置图层模糊和背景模糊。

• 图层模糊：当前图层内包含的所有元素都将被模糊处理。
• 背景模糊：支持模糊处理当前组件底部所覆盖部分。

缩放

配置文本输入组件大小的缩放比例。

旋转

配置文本输入组件围绕中心点旋转的角度。

位移

配置文本输入组件在水平和垂直方向上的移动距离。

倾斜

配置文本输入组件在水平和垂直方向上的倾斜角度。

悬浮效果

配置文本输入组件的悬浮态效果。具体配置说明如下：

• 样式效果：当鼠标悬浮到文本输入组件上时，文本输入组件的样式变化情况。包括背景色、边框等。详细说明，请参考样式设置。
• 变换效果：当鼠标悬浮到文本输入组件上时，文本输入组件的动态变化情况。包括缩放、旋转等。详细说明，请参考变换设置。
• 过渡效果：设置文本输入组件悬浮态的动画效果。
  • 动画效果：支持设置为缓入缓出、缓入、缓出、线性等动画。
  • 持续时间：设置动画的持续时间，单位为毫秒。
  • 延迟时间：设置动画延迟出现的时间，单位为毫秒。
  • 生效范围：设置动画的生效范围。
    • 应用于全部变化：动画效果将应用于样式设置和变换设置所产生的所有变化。
    • 仅应用于变换效果：动画效果仅应用于变换设置所产生的变化。

点击效果

配置文本输入组件的点击态效果。具体配置说明如下：

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

出场效果

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

事件类型

支持以下事件类型：

• 数据改变时：当输入字段的内容改变时触发。
• 鼠标失焦时：当元素失去焦点时触发。
• 鼠标聚焦时：当元素获得焦点时触发。

组件方法

支持以下方法：

• 失焦：使组件失去焦点，通常用于文本输入类组件。
• 聚焦：将焦点设置到指定的组件，使其成为活动状态。
• 清除：清除组件的内容，例如文本输入框中的文字。
• 清除验证：移除组件上的所有验证错误信息。
• 验证：检查组件的当前值是否符合预设的验证规则。
• 重置：将组件恢复到初始状态。
• 设置数据：为组件设置或更新数据。
• 设置禁用：使组件变为禁用状态，用户无法与之交互。