概述

下拉筛选框是一种交互组件，可用于在多个选项中选择一项。用户可以通过公告板数据源写入绑定，或者在集成代码的监听事件中得到更改的数据，来实现可视元件之间的协同工作。

特有属性设置

除了每个组件都拥有的常规静态属性（X, Y, 宽，高，字体等属性）之外，下拉筛选框主要还有如下几类配置项。

输入框

输入框指的是图中用红框圈出的部分，展示了当前选中的选项。它的特有配置项有以下这些：

下拉框

下拉框指的是图中用红框圈出的部分，展示了所有选项标签。它的特有配置项有以下这些：

数据绑定

数据绑定，是连接『可视化仪表盘』与『数据表』的窗口。数据绑定标签中可供选择的数据表，是已在数据标签中创建好的二维数据表。数据表的创建过程可参考 仪表盘数据表处理 及 典型实践文档。

下拉选项

• 数据表：【必填】单选，可选择已创建的数据表。
• 值：【必填】单选，可选择string类型的数据。
• 标签：【必填】单选，可选择string类型的数据。

示例数据

示例数据表如下： 新建静态数据，选择CSV格式，复制下面这段内容到CSV文本输入框中：

value,label
a,选项A
b,选项B
c,选项C

当前值

string类型，【单值】绑定，可参考仪表盘数据绑定。

注意

1. 将当前值与选项中的值对应起来。
2. 与下拉选项绑定不同的数据表。

交互

在设计器页面，可以双击元件进入元件交互；在运行或者分享页面，可以直接与元件进行交互。通过公告板数据源写绑定或PlayerAPI监听事件，均能实现可视元件间的协同工作。详情如下：

写绑定

在文档 组件之间的协同工作 中详细说明了实现组件间协同的操作方法。在下拉筛选框元件中，通过对当前值属性添加写绑定，可以达到如下效果：

PlayerAPI监听事件

交互事件的监听可以通过物可视PlayerAPI中的 onWidgetDOMEvent API。