帮助与文档

> >

一、初始化方法

初始化方法目的是在页面加载完成后,获取请求下发的数据,生成或绑定跳转唤醒APP的事件。

MobLink.init({
    debug: true,
    mobid: "qE",
    path: "demo/a",
    ...
});

详细参数如下:

参数名称

类型

默认值

说明

debug Boolean true 是否开启调试。开启之后可以在浏览器中查看debug信息,以及部分会有弹窗提示。
mobid String 从客户端分享出来的页面会自动在url携带mobid,也可以在页面初始化时手动写入。
path String 与页面相对应的客户端页面路由。
params Object 需要传给客户端的参数。例如,要传入一个pageid,则{pageid: “0”}
showDefaultUI Boolean true 是否显示默认浮层样式。如果想要自定义打开按钮样式,则可以设置false,并且在自定义的元素上添加一个id,例如:id=”moblink-href”。
initCallback Function 初始化成功的回调方法。

二、动态更新携带参数

在初始化的方法中有个params的参数设置,这个参数是为了携带参数传入客户端内,初始化时则会自动合并生成携带了这些参数信息的链接。

但是初始化传入的params参数是固定不变的,在很多情况下我们可能需要传入动态参数,例如一些订票场景,可能需要传入用户选择的数据,这些参数是动态不断在变化的,对此我们也提供了一个更新链接携带参数的方法。

MobLink.updateScheme(data);

 

参数名称

类型

默认值

说明

data Object 需要更新的参数内容。

示例如下:

MobLink.updateScheme({
    key1: "value1",
    key2: "value2",
    ...
})

三、推荐位链接

推荐位链接生成,是个衍生功能。方便在当前页面实现多个页面跳转。

推荐位链接是打开跳转链接的简易版本。配置方式也比较简单,推荐位跳转方式也撇去了打开跳转中的引导页引导跳转,跳转失败默认是停留在当前页。

集成方法: 在需要生成链接的元素上,添加一个属性 “moblink-featured”,如下图所示

tuijian     feature

设置的属性参数格式是: /path?key=value

其中path是需要跳转到客户端中的路径。key=value 是携带的参数的序列化形式。

推荐位的配置不像打开按钮的配置那么繁杂,是直接写在ui上的,自动生成链接的。因此为了部分需要自己绑定的开发者需求,我们提供了一个可以高级定制推荐位的方法。

注意!使用高级定制方法的时候,需要在绑定的元素上添加“moblink-featured”属性,但是后面不跟任何参数。

MobLink.updateFeatured( elementName, path, data, callback );

参数详情:

参数名称

类型

默认值

说明

elementName String 需要绑定推荐位链接的元素名称。示例: “#mob-feature”
path String 跳转至客户端的路径。示例:”scene/news”
data Obj 需要携带传入客户端的参数。示例:{ “key1”: “value1”, “key2”: “value2” }
callback Function 跳转失败后的回调方法。示例:function(){ alert(“跳转失败!”); }