---
order: 1
navTitle: 设置参数值
---
# 仪表板交互-设置参数值

**设置参数值**交互将当前点击的对象所关联的数据设置给指定的参数，参数收到数据变化后，所有引用了参数的可视化组件都将自动更新参数值。如点击饼图的销售大区，所有图表标题里的大区名称都会变成对应大区名称：

![设置参数](./images/2021-11-04-16-10-06.png)

示例地址：[设置参数值](https://demo.succbi.com/v5/bi/%E5%9B%BE%E5%BD%A2%E4%BA%A4%E4%BA%92)

## 使用设置参数值{#start}

使用设置参数值交互，需要提前设置[全局参数](../data/param.md)。以点击饼图的销售大区，图表标题里的大区名称会变成对应大区名称为例，操作步骤如下：

![设置参数](./images/2021-11-04-14-54-28.gif)

1. **设置全局参数：** 点击左上角[参数](../data/param.md)，弹出全局参数对话框，新增参数，如名称为`dq`，描述为`大区`
2. **添加交互并编辑参数：**
   1. 选中`各大区销售数量占比`饼图组件，添加**设置参数值**交互
   2. 在交互中，点击**编辑参数**，进入参数对话框，**参数名称**选择`dq`，**参数值**写为`[区域编码.大区].标题`
3. **引用参数：** 双击打开条形图标题，在标题处引用该参数，如`${[dq]}`，同理将其他图形标题中也引入参数

## 编辑参数{#set-param}

在交互中点击**编辑参数**后，会弹出参数设置对话框，可选择参数名称、以及设置参数值，如下所示：

![参数设置](./images/2021-11-04-16-57-46.png)

- **参数名称**：选择参数名称，该下拉列表中的参数需提前在[全局参数](../data/param.md)中添加
- **参数值**：设置参数值的内容，可动态写入参数值如模型字段、组件等

## 应用场景{#application}

### 通过KPI切换多页面板默认页{#kpi}

在仪表板的制作中，用户经常有这样的需求：点击仪表板中某个KPI，统计图的内容发生变化。
例如

- 点击【累计销售额】，右侧统计图刷新为销售额的相关信息
- 点击【累计销量】，右侧统计图刷新为销量的相关信息

实现步骤如下：

- 定义全局参数：在**设计器工具栏**>**参数**中定义一个变量，用于交互时传递参数使用
  - 设置**全局变量**为`type`，**描述**为`销量和销售额的切换`
- 在KPI组件中设置交互：在**KPI组件**>**交互**中添加**设置参数值**，其他需要交互的组件进行类似操作
  - 生效条件及触发事件默认
  - 在**参数**中点击**编辑参数**，设置**参数名称**为`type`，**参数值**设置为该KPI数据对应的销售指标类型，如销售额，即为`1`
- 设置多页面板动态页：选中需要切换的多页面板，将**数据**>**默认页**设置为`动态页`，动态显示表达式为`IF([type]=1,'销售额','销量')`。这里的销售额和销量分别是指面板的名称，也就是当`type`值为`1`时，显示销售额面板，当`type`值为`2`时，显示销量面板

通过以上3个步骤即可实现点击KPI切换多页面板默认页。

示例地址：[完成率分析](https://demo.succbi.com/v5/bi/%E5%AE%8C%E6%88%90%E7%8E%87%E5%88%86%E6%9E%90)

::: tip
以上是使用动态显示多页面板的页面，来变相实现动态改变图形的指标展示，也可以使用[动态指标](../type/target.md)的方式，来动态控制图形的指标变化，大概思路如下：

1. 定义一个参数用来显示指标名称
2. 在图形的指标上写表达式，例如`case when`或者`if`条件，具体写法可以参考示例中柱形图的展示

示例地址：[指标看板](https://demo.succbi.com/v5/bi/%E6%8C%87%E6%A0%87%E7%9C%8B%E6%9D%BF)
:::