1. 概述
1.1 应用场景
当你面对大量分类数据，并希望用户能够灵活选择特定分类以查看相关数据时，可以使用下拉列表参数。例如，在处理多省份的销量数据时，你可以使用下拉列表参数让用户快速选择感兴趣的省份，从而仅展示该省份的销量数据。
1.2 功能简介
下拉列表参数是一种提供单选或复选功能的列表组件，通过绑定数据源中的字段或手动录入数据，为用户提供参数的选项。用户可以根据需要从列表中选择一个或多个选项，以过滤或展示特定的数据。
2. 应用举例
在销售数据报表中，使用下拉列表参数组件让用户能够自由选择省份，以查看不同省份的销量数据。
操作步骤如下：
1）新建一个报告，创建一个柱状图，绑定“省份”、“销量”并计算销量总和。
2）添加下拉列表参数组件，从组件区域拖拽下拉列表参数组件到画布中。
3）给参数组件绑定数据，选中该组件，打开右侧数据绑定界面，拖拽“省份”字段绑定到值上。
除了绑定数据列，还可以录入数据，详情参考下拉列表参数 > 功能说明 > 录入数据。
4）编辑下拉列表参数组件，具体设置如下：
a)点击右侧的【设置】，布局设置：布局选中“下拉列表”，行数为“5”，列数为“3”，勾选上“内容自适应”和“底部显示按钮”。
b)选项设置：选项选中“多选”，勾选上“选中值置顶”和“默认值为第一个值”，取消默认勾选的“改变时提交”、“显示全选”。
5）给需要参数过滤的组件设置过滤条件，过滤设置如下：
选择已创建的柱状图，点击柱状图组件右上角的“添加过滤”按钮，在“过滤”弹窗中设置过滤条件“省份是其中一个[?{下拉列表参数1}]”。
6）保存报告。预览和查看打开报告时，省份下拉列表参数中默认选中第一个值“安徽”，柱图只展示这一个省份的销量数据。您也可以对其他省份过滤，过滤参考及展示数据如下。
点击
图标展开下拉列表选项，取消选中的“安徽”，选中“江苏”和“上海”，点击“应用”按钮，柱图数据随之变化，展示这两个省份的销量。
【数据绑定】支持绑定值列（列表参数实际传递的参数值）和标签列（参数值的标签，即选项，更利于用户理解）。
➢说明：
下拉列表参数组件的值和标签均只能绑定一个数据列。
【自定义数据】除了绑定数据列，用户还可以录入自定义数据，适用于数据量少且数据集中无相关数据列的场景。
点击“录入数据”按钮，在弹窗内定义数据类型（文本、数值、日期时间等）和具体值。
【数据类型】默认数据类型为文本，可以根据需要传递的参数值类型自己定义。可选类型包括文本、数值、日期时间、布尔、高级。高级包括单精度浮点数、双精度浮点数、字符、字符串、字节、布尔、整数、日期、时间、时间戳、短整数、长整数、高精度。
例如我们要筛选“云南”、“四川”，类型选择文本即可。
【添加数据列值】勾选数据列名，将数据列名当做值添加到后面的值列，成为参数组件的值。一般用于使用参数列的场景，详情请参考数据处理与分析 > 动态绑定。
【值与标签】用户可以录入值（列表参数实际传递的参数值）和标签（参数值的标签，即选项，更利于用户理解）。如果录入标签，则下拉选项中显示标签；否则，显示值。
例如给“云南”设置标签“云南省”，下拉选项中会显示“云南省”。
【添加/删除】添加和删除自定义数据。
【上移 / 下移】选中数据行，点击上移或下移，可改变数据的上下位置。
3.2 空值筛选
参数组件默认会过滤掉空值，用户无法直接通过参数组件筛选空值数据。要想筛选空值数据，需要在数据集中对空数据做缺失值填充，设置方法参考缺失值填充。将空值替换为特定值后，可通过参数组件对特定值进行筛选。
3.3 布局
布局设置详细说明可参考下拉列表过滤 > 功能说明 > 布局 。
3.4 选项
选项设置详细说明可参考下拉列表过滤 > 功能说明 > 选项。
3.5 编辑器
【必填】用于数据填报。默认不勾选，若勾选了“必填”，必须选择了值才能提交填报。
3.6 格式
您还可以在右侧【格式】设置组件样式，包括文本、边框、背景色、透明度等，详情参考组件操作与设置 >格式。