1. 概述
1.1 应用场景
文本参数组件适用于需要灵活筛选目标数据的场景。通过文本参数，用户可以轻松实现基于关键字的数据筛选，满足复杂的数据分析需求。例如，在查看产品销售情况时，用户可以通过输入“茶”作为关键字，快速筛选出包含“茶”的所有品类的销量情况。
1.2 功能简介
文本参数组件是一个允许用户输入文本的控件，用于在数据分析过程中提供灵活的筛选条件。该组件仅支持输入，不支持数据选项绑定，但可以根据定义的数据类型来校验输入的合法性。对于日期类型，还提供了日历控件以便用户选择。输入完成后，用户可以通过回车或点击空白处确认输入内容，系统将根据数据类型自动校验输入的有效性。
以下示例展示了如何在产品中使用文本参数组件来筛选并展示特定产品种类的销量情况。
操作步骤如下：
1)新建一个报告，创建一个柱状图，绑定“产品种类”、“销量”并计算销量总和。
2)添加文本参数组件，从组件区域拖拽文本参数组件到画布中。
3)点击右侧的编辑栏【设置 > 编辑器】，勾选上“支持输入多个值”，分隔符为自定义的“-”。
4)编辑双击文本参数标题，修改为“产品种类”。
4）给需要参数过滤的组件设置过滤条件，过滤设置如下：
选择已创建的柱状图，点击柱状图组件右上角的“添加过滤”按钮，在“过滤”弹窗中设置过滤条件“产品种类是等于[?{文本参数1}]”，如下图：
5）保存报告。预览或查看报告时，在产品种类文本参数的输入框中填写“茶-花茶”，柱图中展示茶、花茶的销量。
您也可以对其他产品种类过滤，过滤参考及展示数据如下。如需查看咖啡的销量，填写“咖啡”即可，柱图数据随之变化。
3.1 空值筛选
参数组件默认会过滤掉空值，用户无法直接通过参数组件筛选空值数据。要想筛选空值数据，需要在数据集中对空数据做缺失值填充，设置方法参考缺失值填充。将空值替换为特定值后，可通过参数组件对特定值进行筛选。
3.2 选项
选项设置说明可参考下拉列表过滤 > 功能说明 > 选项。
3.3 编辑器
文本参数组件的编辑器允许用户根据不同的使用场景选择数据类型，并匹配相应的控件。不同的控件支持定义的值有所不同，用户可以根据需要设置规则、模式检测、出错提示信息和必填等属性。例如，对于日期类型，编辑器将提供日历控件供用户选择日期。详细设置参考编辑器。
3.4 格式
您还可以在右侧【格式】设置组件样式，包括文本、边框、背景色、透明度等，详情参考组件操作与设置 > 格式。