参数
学习视频:
选中一个容器,可以在对象面板中添加一个参数对象,如下图:
但点击时却出现了下面这样的一个提示窗口:
这是因为,这里要添加的参数实际上是系统中添加的参数的查询组件,所以要添加一个参数查询组件到仪表板中,我们需要首先配置好系统参数。
点击工具栏上的设置按钮,在弹出的窗口中的第一个标签页中就可以配置我们需要的参数,如下图:
上图当中,我们添加了一个名为name的参数,值类型为字符串,默认值为空。有了这个参数后,接下来再次点击对象面板上的参数按钮,就可以看到如下图所示窗口:
在这个参数配置窗口中,默认就有两个参数查询组件,一个是全局参数name,另一个是查询按钮,我们选择name,然后确定,就可以在控制台中看到这个查询组件,如下图:
参数属性
选中参数后,就可以在右侧属性面板中对其属性进行调整。
属性名 | 描述 |
---|---|
标题 | 当前查询组件的标题,默认与参数名称相同,当然也可以清空不显示 |
值更改时提交查询 | 如果勾选,表示在输入值时,将输入的值作为当前参数的值实时传输到后端配合数据集进行数据查询 |
占位符 | 仅在当前参数查询组件编辑器类型为文本框时有效,如果输入值,那么就是当前文本框的点位符值 |
值前缀 | 如果我们在SQL数据集中使用了当前参数作为like查询,那么就可以在这里设置值为%,这样输入任何值都会在值前添加%符号,以实现SQL中like查询的前匹配功能 |
值后缀 | 如果我们在SQL数据集中使用了当前参数作为like查询,那么就可以在这里设置值为%,这样输入任何值都会在值后添加%符号,以实现SQL中like查询的后匹配功能 |
编辑器类型 | 目前支持的参数查询组件的编辑器类型有两种:文本框和下拉框,选择为下拉框时,可以绑定静态列表值,也可以与数据集绑定产生动态列表值。 |
查询按钮
添加参数时,如果我们选择的是查询按钮,那么就会在当前容器中出现一个按钮,如下图:
如果在添加其它类型的参数查询组件时,未勾选值更改时提交查询项,那么可以通过添加一个查询按钮来触发查询参数的提交工作。可以看到查询按钮的属性值也比较简单,主要是对其外观样式进行修改,运行时,点击查询按钮,那么它会将当前仪表板中所有的查询组件值绑定到对应参数中提交到后端处理。