平铺列表

1.1 应用场景

在预览仪表板时，用户希望对文本类型的字段进行筛选，查看对应的数据信息。

当筛选项数量适中，且希望查看者不需要展开下拉框即可直接查看并勾选筛选项时，可以使用平铺列表筛选器。

例如，仪表板中展示了多个地区的销售数据，查看者希望通过筛选，快速查看一个或多个地区对应的销售情况。

1.2 功能介绍

平铺列表筛选器会将筛选项直接展示在仪表板页面中，查看者可在列表中勾选筛选项，查看对应的数据结果。

平铺列表支持单选和多选。开启多选后，查看者可一次选择多个筛选项，也可在搜索框中批量粘贴多个筛选值，快速完成筛选。

2.1 编辑仪表板

创建一张仪表板或进入已有仪表板的编辑界面。

2.2 添加平铺列表筛选器

点击组件区「筛选器>平铺列表」，将其添加到页面中。

2.4 绑定筛选字段

1）选中平铺列表筛选器，点击「属性」进行绑定筛选字段。

2）点击「添加字段」，选择进行筛选的字段，再选中想要进行筛选的图表。

3）若想在平铺列表中实现多选，需勾选「开启多选」。

开启多选后，平铺列表中显示复选框，查看者可同时勾选多个筛选项。

在右侧「属性」设置中，可以设置选项来源、默认值、多选等内容，详情参见文档：筛选器内容设置。

3.1 支持批量粘贴

开启多选后，平铺列表支持在搜索框中批量粘贴多个筛选值。

粘贴内容需按行分隔，一行对应一个筛选值。粘贴后，搜索框中显示「已粘贴 X 个选项」，按 Enter 键可添加全部粘贴内容。

例如，将以下内容复制后粘贴到平铺列表搜索框中：

北京市
上海市

列表类型的筛选器支持切换格式。例如，可在「下拉框、按钮组、平铺列表」之间切换筛选器类型。

切换筛选器格式后，原筛选字段、选项来源、默认值等配置会尽量保留；不同筛选器特有的展示样式需根据切换后的类型重新确认。

点击仪表板右上角「保存」，点击「预览」，即可查看平铺列表筛选器效果。

不勾选「开启多选」时，每次仅能选择一个筛选项。

勾选「开启多选」时，可以选择多个筛选项。若列表中开启「全选」，查看者可通过「全选」快速选择当前列表中的筛选项。