多行输入

标签

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

标签内容

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

占位文案

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

字符上限

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

默认值

配置多行输入组件的默认值。

组件布局

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

垂直对齐

配置多行输入组件的垂直对齐方式。

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

输入区颜色

配置多行输入框背景的显示颜色。

输入区边框

配置多行输入组件背景的边框颜色、边框的粗细和边框的样式。

宽度

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

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

高度

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

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

尺寸限制

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

最小高度

配置多行输入组件的最小高度，默认值为 96px。

填充

配置多行输入组件背景的显示颜色。

圆角

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

内边距

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

外边距

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

边框

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

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

阴影

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

• 预设样式：提供预设的阴影样式，可直接使用。
• 自定义样式：支持通过样式、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，多行输入组件展示加载态。

点击效果

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

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

出场效果

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

事件类型

支持以下事件类型：

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

组件方法

支持以下方法：

• 设置数据：为组件设置或更新数据。
• 设置禁用：使组件变为禁用状态，用户无法与之交互。
• 复制到剪切板：复制文本内容到剪切板。
• 设置隐藏：隐藏组件，使其不可见。