版本: 下个版本

下拉选择器

下拉选择器是高级交互组件的一种，可以作为下拉框表单在可视化应用中使用，将用户选择的数据提交到后端进行处理或者通过交互配置，在其他组件上显示用户选择的内容。本文介绍下拉框选择器各配置项的含义。

配置

基础属性：包含组件的基础属性

参数	说明
图表宽度	组件的宽度
图表高度	组件的高度
横坐标	组件的横坐标，单位为px。横坐标为组件左上角距离页面左边界的像素距离
纵坐标	组件的纵坐标，单位为px。横坐标为组件左上角距离页面上边界的像素距离
旋转角度	以组件的中心为中心点，进行旋转，单位为度（°）
透明度	取值范围为0~1。为0时，图表隐藏；为1时，图表全部显示。默认为1

输入框

默认选中：自定义设置默认选中的条目，输入框内的内容必须是数据面板中的value字段中已有内容，否则展示提示文本内容（路径为：输入框 > 内容样式 > 提示文本内容）。
功能增强：输入框的功能增强样式。

参数	说明
下拉搜索	打开开关，输入框可自定义输入搜索内容，过滤选出对应下拉列表内的数据内容；关闭开关，无法使用自定义输入搜索内容功能。
选中清除	打开开关，输入框选中一个条目后右侧会出现图标，单击该图标可以清除输入框内被选中的内容；关闭开关，无法使用清除选中内容的功能。
定制回填内容	输入框选择一个下拉条目后，输入框内所展示的内容类型。可选auto（默认全部展示）、value（展示数据中value字段值）和title（展示数据中title字段值）。

边框样式：输入框边框的样式。

参数	说明
默认	默认边框下的线粗细、线的可选类型、线颜色和边框圆角的角度值。
悬浮	鼠标悬浮在输入框边框时，输入框边框的线粗细、线的可选类型、线颜色和边框圆角的角度值。
选中	鼠标单击输入框边框时触发，输入框边框的线颜色值。

内容样式：输入框内容的样式。

参数	说明
文本缩进	输入框内提示文字的缩进值，单位为px。
背景颜色	输入框的背景颜色。
内容文本	输入框里内容文本的样式，包括文本的字体样式、文字粗细、字号和颜色。
文本样式	搜索时输入的文本的样式、提示文本样式、下拉列表为空时显示文本的内容样式，包括文本的字体样式、文字粗细、字号和颜色。
提示文本内容	输入框内为空时提示文本的内容。

箭头样式：下拉框箭头的样式，可单击图标控制箭头样式的显隐。

参数	说明
大小	下拉框箭头的大小。
颜色	下拉框箭头的颜色。
右边距	下拉框箭头与组件右边界的距离。

清除样式：下拉框的清除样式。

参数	说明
大小	下拉框清除图标的大小。
颜色	下拉框清除图标的颜色。
右边距	下拉框清除图标与组件右边界的距离。
背景色	下拉框清除图标的背景色。

下拉框

高度：下拉框高度样式。

参数	说明
列表高度	下拉框整体列表高度值。
选项高度	下拉框中每个选项的高度，单位为px。
容器顶部间距	下拉框容器顶部距离下拉框选择器的距离，单位为px。

背景：下拉框背景颜色。
边框：下拉框边框的样式。

参数	说明
粗细	下拉框边框线的粗细值。
类型	下拉框边框线类型样式，可选实线、虚线、点线、双实线、雕刻效果、浮雕效果、陷入效果和突出效果。
颜色	下拉框边框的颜色。
圆角	下拉框边框圆角的大小，取值范围为0~360。数值为0的时候下拉框为方形，数值为360时下拉框为圆形。

文本：下拉框内选项文本的样式。

参数	说明
字体	下拉框内选项文本的字体样式。
文字粗细	下拉框内选项文本的文字粗细值。
字号	下拉框内选项文本字号大小。
颜色	下拉框内选项文本的颜色。

边距：下拉框内选项的内容与选项四周边框的距离。
图标配置：下拉框选项文本左侧图标的配置样式，可单击图标控制图标配置的显隐。

信息

说明下拉框选项中的图标配置配置项内容需与数据面板中的imgSrc字段内容相匹配。组件示例数据面板中默认只配置了第一个数据的图标字段，如您还需配置其他选项的图标，可自定义配置对应数据项的imgSrc字段。

参数	说明
宽度	图标的宽度。
高度	图标的高度。
距离文字间距	图标与文字之间的距离。

选项悬浮样式

参数	说明
背景	鼠标悬浮到下拉框内选项时的背景颜色。
文本	鼠标悬浮到下拉框内选项时的文本样式，包括文本的字体样式、文字粗细、字号和颜色。

选项选中样式：被选中的下拉框选项的样式，请参考上文的选项悬浮样式进行配置。

数据

上图中的示例数据如下。

[
    {
        "title": "Beijing",
        "value": "北京",
        "imgSrc": "https://uniplore-source.oss-cn-chengdu.aliyuncs.com/bigscreen/images/%E5%8C%97%E4%BA%AC.png"
    },
    {
        "title": "Shanghai",
        "value": "上海"
    },
    {
        "title": "Guangzhou",
        "value": "广州"
    },
    {
        "title": "Shenzhen",
        "value": "深圳"
    },
    {
        "title": "Tianjin",
        "value": "天津"
    },
    {
        "title": "Chongqing",
        "value": "重庆"
    },
    {
        "title": "Suzhou",
        "value": "苏州"
    },
    {
        "title": "Chengdu",
        "value": "成都"
    },
    {
        "title": "Wuhan",
        "value": "武汉"
    },
    {
        "title": "Hangzhou",
        "value": "杭州"
    },
    {
        "title": "Nanjing",
        "value": "南京"
    }
]

表 1. 字段说明

字段	说明
title	下拉框选择器中各选项的弹窗的标题内容。
value	下拉框选择器中各选项的实际显示的值。
imgSrc	下拉框选择器中各选项的图标，只有当配置栏内的图标配置项开启时可被展示。

表 2. 配置项说明

配置项	说明
受控模式	打开开关，组件初始化状态下不请求数据，仅通过回调ID或蓝图编辑器配置的方法发起请求数据；关闭开关，可以使用自动更新请求数据。
自动更新请求	选中后可以设置动态轮询，还可以手动输入轮询的时间频次。清除后则不会自动更新，需要手动刷新页面，或通过蓝图编辑器和回调ID事件来触发请求更新数据。
数据源	可以选择数据源，如下图。
数据响应结果	展示数据请求的响应结果。当数据源发生改变时，可单击右侧的查看响应数据，实时查看数据响应结果。

交互

选中下拉框内容被选中右侧的启用，开启组件交互功能。下拉框选择器组件拥有交互配置，可改变下拉框选择项中的内容，触发数据请求，抛出回调值，然后在其他组件中配置使用。默认抛出数据面板中配置的title、value和imgSrc值，具体配置请参见回调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"}}`

配置​

基础属性：包含组件的基础属性​

输入框​

下拉框​

数据​

表 1. 字段说明​

表 2. 配置项说明​

交互​

蓝图编辑器交互配置​

配置

基础属性：包含组件的基础属性

输入框

下拉框

数据

表 1. 字段说明

表 2. 配置项说明

交互

蓝图编辑器交互配置