如何向网页控件中传递参数(V5.7.06版本)
DataViz中图册与图册中的网页控件之间支持2种传递参数的方法,第一种是通过postMessage进行通信,这种方式可以支持图册和网页控件进行双向通信,但是不能跨域。详情参考:Web 网页资源通信。
另一种就是通过URL进行传参,这种方式只能有图册向网页控件中进行单向的传参,但不会受到跨域的影响。接下来就主要介绍图册中如何通过URL向网页控件中传参。
1. 向网页中传递图册访问地址中的参数
例如:图册播放地址为http://ip:port/dataviz-web/src/q.html?b=xxx-xxx-xxx&search=xxxxx
如果我们想把search参数的值传递到网页控件中,我们在填写网页地址的时候需要使用[search]来表示search参数的值 例如: http://www.baidu.com?test=[search]
test为网页中控件中接受search参数的参数名,可以根据需要自行定义名称。
2. 向网页中传递当前用户的信息
向网页中传递用户信息的方式与上面传递URL参数的方法类似 ,我们在填写网页地址的时候需要使用[userKey]来传递用户的信息。
目前可选的userKey只有3个:
- id, 当前用户ID;
- name, 当前用户名;
- loginName, 当前用户登录名;
例如:http://www.baidu.com?user=[id] 表示传递用户ID信息。
3. 向网页中传递图册中的SQL参数
DataViz中支持在创建SQL数据集时使用SQL参数进行占位,用户在图册播放时可以设置这些SQL参数的值。如果我们想把SQL参数的值传入网页控件,
我们需要在网页控件中勾选“通过URL向网页传递当前图册中的参数”,如下图所示:
例如:现有参数A,参数标识为:test,值为:xxx;网页控件地址为:http://www.baidu.com;
勾选“通过URL向网页传递当前图册中的参数”后最终的访问地址:http://www.baidu.com?test=xxx 。