Skip to content

网页

打开一个网页

传入地址,新窗口打开网页。

使用说明

客户端AndroidiOS
支持情况支持支持
js
w6s.webview.openWebView({
  url: 'http://网页地址',
  title: 'Test'
});

参数说明

参数类型说明
urlString要打开的网址 url
titleString显示的标题
useAndroidWebviewBoolean是否使用 android 原生 webview 打开, 否则使用 BeeWorks 订制的 webview
useSystemWebviewBoolean等同于 useAndroidWebview,只是该参数能用于 iOS 以及 Android平台
displayModeString全屏打开 webview(即不包含原生标题栏),默认非全屏
orientationnumber横竖屏设置,1 表示竖屏 2表示横屏,默认是追随手机设置

退出

关闭整个 WebView。

使用说明

客户端AndroidiOS
支持情况支持支持
js
w6s.webview.exit();

弹出分享对话框

弹出分享对话框,跳转分享。

使用说明

客户端AndroidiOS
支持情况支持支持
js
w6s.webview.share({
  url: 'https://www.beeworks.cn'
  title: 'BeeWorks'
  coverMediaId: '分享图标mediaId',
  coverUrl: '分享图标 url', 
  scope: 0 
  summary : '这是一段摘要',
  directly: 'w6s_contact',
  directSession: {
    id: 'id',
    type: 'discussion',
  },
});

参数说明

参数类型说明
urlString要分享的网页地址
titleString分享后显示的标题
coverMediaIdString分享后显示的图标,媒体id
coverUrlString分享后显示的图标,网络地址,与 coverMediaId 二选一即可
scopeNumber用于显示范围,0 只显示内部分享的操作,包括"发送给","分享到圈子";1则显示全部
summaryString分享的内容摘要,一般会放到分享后的描述位置
directlyString可选值:w6s_contact、w6s_current_session,具体说明请看下方描述
directSession.idString会话的id
directSession.typeString会话的类型

directly 参数

直接执行分享操作支持: w6s_contact对应“分享弹出窗”的“发送给”,为App内部的联系人等列表;w6s_current_session表示直接分享给指定会话,无任何弹出窗或者选择界面。当directly存在值时,scope参数无意义,请忽略, 默认directly为空,也即该接口会显示”分享弹出框“。

控制屏幕旋转

根据参数控制屏幕横屏显示或者竖屏显示。

使用说明

客户端AndroidiOS
支持情况支持支持
js
w6s.webview.changeOrientation({
  landscape: true,
  lock: true,
});

参数说明

参数类型说明
landscapeBoolean表示横屏或者竖屏,非必须
lockBoolean表示锁定当前横屏或者竖屏的状态, false 表示 app 随用户系统设置来控制旋转,默认是 false

lock 参数在低于 4.9.1 版本的 APP 下可能无效。

添加水印

给页面添加水印。

使用说明

客户端AndroidiOS
支持情况支持支持
js
w6s.webview.addWaterMask({
  textColor: '#000000',
  orgId: 'xxxid',
  alpha: 1.0,
  verticalPadding: 40,
  fontSize: 16,
});

参数说明

参数类型说明
textColorString字体颜色
orgIdString组织id,传值则以这个组织下的雇员名显示内容,可不传,默认当前组织
alphaNumber水印文字透明度 0-1.0之间,可不传, 默认1.0
verticalPaddingNumber水印文字上下的垂直高度(密度),可不传,默认40
fontSizeNumber字体大小,可不传,默认16

移除水印

给页面移除水印。

使用说明

客户端AndroidiOS
支持情况支持支持
js
w6s.webview.removeWaterMask();

注册摇一摇监听

注册摇一摇监听。

使用说明

客户端AndroidiOS
支持情况支持支持
js
w6s.webview.registerShakeListener();

前端需要实现onWorkplusShake()方法, 在该处执行自己的业务, 摇一摇后将在该方法回调。

onWorkplusShake

该方法必须为全局方法,并且方法名不可以转换。

注销摇一摇监听

注销摇一摇监听。

使用说明

客户端AndroidiOS
支持情况支持支持
js
w6s.webview.unregisterShakeListener();

微信分享(会话/朋友圈)

根据接口直接调起微信分享页面。

使用说明

客户端AndroidiOS
支持情况支持支持
js
w6s.webview.wxShare({
  appId: 'wx63f4a539bf345965',
  title: '这是一个标题',
  type : 'webpage',
  description: '这是概要',
  thumb: 'base64://xxxxx==',
  scene: 0,
  data: { 'url': 'https://www.beeworks.cn' }
});

参数说明

参数类型说明
appIdString微信的AppId
titleString分享的标题
typeString分享的消息类型,webpage(网页链接), image(图片)
descriptionString描述
thumbString缩略图数据,为 base64
sceneNumber0 为聊天界面 1为朋友圈
dataObject{'url': 'www.beeworks.cn'} or

data参数的值,请注意:

  • type 为webpage时,url 字段为分享的链接;
  • type 为image时,image 为分享的图片链接或者是 base64。

下拉刷新

页面下拉刷新功能,需要由一系列的接口组合而成,并且该功能是针对当前 WebView 起效。在开发轻应用时要特别注意,特别是单页面应用,在页面切换时,需要考虑是否清空下拉刷新功能。

使用说明

客户端AndroidiOS
支持情况v4.11.6+v4.11.6+

开启

当页面需要下拉刷新功能时,先通过下方接口,启动“下拉刷新”能力。

js
sdk.webview.configPullRefresh({
  enable: true,
  mode: 'default',
  success: () => {},
  fail: () => {},
});

参数说明

参数类型说明
enableBoolean下拉刷新功能的开关
modeString下拉的模式,目前仅支持 “default” 的默认类型

监听下拉

用户下拉屏幕的动作,需要通过下面的方法进行监听。例如一下新闻列表页面,用户下拉页面头部后,该接口的回调就会被触发,此时开发者可以通过调用接口更新新闻列表,成功后手动结束刷新。

js
sdk.webview.onPullRefresh({
  success: () => {
    console.log('加载中...);
    setTimeout(() => {
      // 调用下方“完成刷新”接口
    }, 3000);
  },
  fail: () => {
    console.log('fail');
  },
});

完成刷新

调用该接口后,刷新动作会马上完成,动画会停止并收起。

js
sdk.webview.endPullRefresh();

停止

当页面不需要刷新功能时,需要调用下方接口进行停止。如果需要再次开启,请调用上方的“开启”接口。

js
sdk.webview.configPullRefresh({ enable: false, mode: 'default' });