# 变量池介绍

即视支持用户创建变量,变量池存储用户创建的变量,变量可在即视中所有可输入的地方使用。您可将创建好的变量绑定至交互组件中或填写入数据源中,进行返回值绑定、数据切换等操作。

# 变量池管理

# 增加变量

切换至数据源面板,将左侧面板切换至变量池与数据源面板。单击变量池添加按钮,添加一个变量。

$vp代表变量池,在即视中获取变量需要使用${}包裹。比如我们想要取出变量池中存储的test变量,即${$vp.test}

  • 填写变量名称以及变量初始值,变量名称不允许与已有变量名相同。
  • 可在变量中添加字符串、数组、数字,变量中不支持填写函数和json对象。
  • 默认输入字符为string类型,如果只使用数字填入则默认为number类型,使用""将值括起来则为string类型。
  • 变量值不支持在输入框内进行计算,如1-2等形式则默认为字符串。
  • 输入nullundefined 会转成实体对象,即null值与undefined
  • 如果未填写变量初始值,变量将创建失败。
  • 在变量值中不支持引入其他变量。

比如已存在的变量test1,新建test2变量值为${$vp.test},此时无法识别${$vp.test},转为string字符串。

# 编辑变量

双击或右键已创建成功的变量,可对变量进行编辑。

# 删除变量

右键变量点击删除,删除变量后,与变量绑定的交互组件也将自动解绑。若删除与返回值绑定的组件或文本的变量,会导致组件无法正常显示。

# 使用变量

一般来说,在即视中所有组件无论是组件数据、组件配置项,只要可输入的地方都可以使用变量。变量可用于展示,数据源切换,返回值绑定,事件传值。

# 展示变量值

  • 比如使用文字组件展示变量值,直接在文字组件编辑栏中点击数据源按钮,输入${$vp.test},即可显示变量值。当变量值修改时,文字组件显示也随之修改。

  • 在交互组件中,将左侧面板切换至组件数据面板,在数据源中写入变量,但是需要注意某些交互组件支持不同的数据格式。比如在数字翻牌器中引入变量test,需要number类型的变量。

# 绑定返回值

  • 在交互组件中将返回值绑定至某个变量可暂时修改变量值,但是不会修改变量本身的值。

# 数据源切换

  • 在http/https数据源地址中增加变量,通过改变变量修改图表数据源

# 事件中使用变量

  • 在交互组件的事件监听中也支持使用变量,以按钮组件举例,在鼠标单击事件中使用$global.$vp.test++使变量test+1.

# 图表配置项中使用变量

  • 在图表组件中,给y轴的数值后加上变量池的变量。创建变量值为'元'的变量,在图表y轴配置项中展开配置【自定义文本】,将变量与y轴的值拼接。