jhbridge
v0.0.8
Published
江湖 JS bridge
Downloads
4
Readme
JHBridge
江湖 JS Bridge API
npm install jhbridge --save
浏览器中包括两个view,APP View 和 POP View。
APP View 是主程序所用的 Webview POP View 是小程序所用的 Webview
const JHBridge = require('jhbridge');
JHBridge.view.back() // 当前 Webview 返回上一页
JHBridge.view.show() // 显示小程序页面,传入是否清理上次浏览内容的标识
JHBridge.view.hide() // 隐藏小程序页面
JHBridge.view.load({ url }) // 加载小程序页面
JHBridge.info.Android // true | false 在Android上
JHBridge.info.IOS // true | false 在IOS
JHBridge.info.APP_VIEW // true | false 在APP_VIEW里
JHBridge.info.POP_VIEW // true | false 在POP_VIEW里
JHBridge.info.NO_VIEW // true | false 不在APP里
JHBridge.info.VERSION // x.x.x 当前APP的版本
以上逻辑均可以在 APP View 和 POP View 里面使用。
小程序一般正确使用姿势:
使用 view.load({url:"http://xxxx.xxx"})
加载小程序网址
然后使用 view.show()
显示POP View,不一定紧跟在load
后面,也可以在 POP View 里面触发。
view.show()
可以在 POP View 的业务逻辑里写,比如不需要用户来主动触发的POP View(活动等),需要定时弹出的POP View,可以在页面 Dom 加载完成、业务逻辑执行的时候显示,比如,我们可以在小程序里面判断当前用户是否需要弹出这个POP View,就不用再主程序里面判断当前用户是否需要弹出了。
注册接收native传来的消息
JHBridge.native.addReceiveListener
const func = (evt, arg)=>{
};
JHBridge.native.addReceiveListener(func);
可注册多个,接收两个参数:
- evt: (string)事件名称
- arg: (string)参数内容
比如推送被点击的事件名称为'notification'
,arg是一个json格式的字符串。
JHBridge.native.removeReceiveListener
可以删除注册的事件
JHBridge.native.removeReceiveListener(func); // func保证与注册时候的函数指向相同的地址。
JHBridge.native.flushReceive
在注册 addReceiveListener
之前,可能已经有消息发送过来了
比如应用关闭状态下,接收到推送的时候,点击推送其实会发送 notification 事件到 H5,但是这时候还没有调用 addReceiveListener
,所以在 addReceiveListener
以后,需要调用 JHBridge.native.flushReceive()
,来处理被缓存的事件。
修改 POP View 的配置
JHBridge.view.setConfig(config);
config 参数
{
hardware: true,
clickAlpha: 0.2
}
hardware
用来开启硬件加速,3d游戏可以开启硬件加速,默认为false
clickAlpha
点透率,0-1 之间,如果设置为 0.2,那么,页面中透明度为 0.2 以下的内容是不会拦截点击事件的,可以直接点击到 APP View 层。比如 POP View 页面和APP View 页面配合交互的场景,POP View 用来引导点击 APP View 上的某个按钮。