输入框
输入框是高级交互组件的一种，支持自定义输入框的背景颜色、文本样式、边框样式以及多种状态下输入框按键的样式等，可以作为输入表单在可视化应用中使用，将用户的输入提交到后端进行处理。本文介绍输入框各配置项的含义。
配置
基础属性：包含组件的基础属性
输入框 样式
提示文字：输入框显示的提示文本内容，也可以在数据中进行配置。
信息
说明
- 提示文字内容获取优先级是：数据 >**配置 **。
- 只有清空数据面板中value字段里面的内容后，组件才会显示配置面板中提示文字的内容。
缩进：输入框内提示文字的缩进。
输入框背景颜色： 输入框的背景颜色 。
文本样式：输入框中文本的样式。
| 参数 | 说明 |
|---|---|
| 颜色 | 输入框中文本的颜色。 |
| 字体样式 | 文本的字体样式，包括normal、italic和oblique。 |
| 字体粗细 | 文本的字体粗细。 |
| 字体 | 文本的字体系列。** |
| 字号 | 文本的字体大小。 |
信息
说明 请选择您系统中已经安装的字体，如果您系统中没有选择的字体，组件文本会显示为默认的字体样式。
边框样式
| 参数 | 说明 |
|---|---|
| 边框宽度 | 边框的宽度，单位为px。 |
| 边框颜色 | 边框的颜色。 |
| 边框圆角 | 边框的圆角，取值范围为0~360。数值为0时输入框为方形，数值为360时输入框为圆形。 |
| 线条类型 | 边框的线条类型。包括实线、虚线、点线、双实线、雕刻效果、浮雕效果、陷入效果和突出效果。 |
按键样式：输入框右侧的按键样式。
输入框文本内容：按键的文本内容。
按键宽度：按键的宽度值。
信息
注意 宽度设置过小会导致按键的文本溢出。
普通样式
- 背景颜色：按键的背景颜色。
- 边框样式
| 参数 | 说明 |
|---|---|
| 边框宽度 | 按键边框的宽度。 |
| 边框颜色 | 按键边框的颜色。 |
| 边框圆角 | 按键边框的圆角，取值范围为0~360。数值为0的时候按键为方形，数值为360时按键为圆形。 |
| 线条类型 | 线条的类型。包括实线、虚线、点线、双实线、雕刻效果、浮雕效果、陷入效果和突出效果。 |
- 文字样式
| 参数 | 说明 |
|---|---|
| 颜色 | 按键文本的颜色。 |
| 字体样式 | 文本的字体样式。 |
| 字体粗细 | 文本的字体粗细样式。 |
| 字体 | 文本的字体系列。** |
| 字号 | 文本的字体大小。 |
信息
说明 请选择您系统中已经安装的字体，如果您系统中没有选择的字体，组件文本会显示为默认的字体样式。
点击样式：鼠标单击输入框按键时的样式，请参见普通样式进行配置。
悬停样式：鼠标悬停在输入框按键上时的样式，请 参见普通样式进行配置。
数据
上图中的示例数据如下。
[
{
"value": "值"
}
]
表 1. 字段说明
| 配置项 | 说明 |
|---|---|
| value | 输入框中显示的内容，配置后会覆盖样式中提示文字的内容。可以为空，为空时会读取样式配置中的内容。 |
表 2. 配置项说明
| 配置项 | 说明 |
|---|---|
| 受控模式 | 打开开关，组件初始化状态下不请求数据，仅通过回调ID或蓝图编辑器配置的方法发起请求数据；关闭开关，可以使用自动更新请求数据。 |
| 自动更新请求 | 选中后可以设置动态轮询，还可以手动输入轮询的时间频次。清除后则不会自动更新，需要手动刷新页面，或通过 蓝图编辑器和回调ID事件来触发请求更新数据。 |
| 数据源 | 可以选择数据源，如下图。  |
| 数据响应结果 | 展示数据请求的响应结果。当数据源发生改变时，可单击右侧的查看响应数据，实时查看数据响应结果。 |
交互
选中当前值变化时和当按钮点击时右侧的启用，开启组件交互功能。输入框组件拥有交互配置，可改变输入框中的内容，触发数据请求，抛出回调值，然后在其他组件中配置使用。 默认抛出数据面板中配置的 value 值，具体配置请参见回调ID实现图表联动功能。
蓝图编辑器交互配置
- 在画布编辑器页面，右键单击组件，选择导出到蓝图编辑器。
- 单击页面左上角的
图标。 - 在蓝图编辑器配置页面，单击导入节点栏内的输入框组件，在画布中可以看到如下图所示的输入框的蓝图编辑器配置参数。
- 事件
| 事件 | 说明 |
|---|---|
| 当数据接口请求完成时 | 数据接口请求返回并经过过滤器处理后抛出的事件，同时抛出处理后的JSON格式的数据。具体数据请参见上文的数据系列。 |
| 当前值变化时 | 当前值发生变化时抛出的事件，同时抛出该值对应的数据项。 |
| 当按钮点击时 | 当按钮被单击时抛出的事件，同时抛出该值对应的数据项。 |
- 动作
动作 | 说明 |
|---|---|
| 请求数据接口 | 重新请求服务端数据，上游数据处理节点或图层节点抛出的数据将作为参数。例如输入框配置了API数据源为[http://api.test](http://api.test)，传到请求输入框接口动作的数据为{ id: '1'}，则最终请求接口为[http://api.test?id=1](http://api.test?id=1)。 |
| 导入数据接口 | 按组件绘制格式处理数据后，导入组件，重新绘制。不需要重新请求服务端数据。具体数据请参见上文的数据系列。 |
| 获取当前输入框值 | 表示获取当前输入框中的值。 |
| 清空组件到默认值 | 表示还原到默认选中的值。 |
| 更新组件配置 | 动态更新组件的样式配置。需要先在组件的配置面板中，单击复制配置到剪贴板，获取组件配置数据。再根据需要在蓝图编辑器配置页面的数据处理节点中更改对应样式的字段值。 |
| 显示 | 显示组件，不需要参数。 |
| 隐藏 | 隐藏组件，不需要参数。 |
| 切换显隐状态 | 切换组件显示或者隐藏。 |
| 移动 | 将组件移动到指定位置。{// 移动方式。绝对定位：to，相对定位：by。默认值：to。"positionType": "to",// 指定位置。x坐标，y坐标。"attr": {"x": 0,"y": 0},// 动画方式。"animation": {"enable": false,// 动画延时。"animationDuration": 1000,// 动画曲线。可选值为：linear|easeInOutQuad|easeInOutExpo。"animationEasing": "linear"}} |