Webview

URL传参控制

由于JS-API在页面加载后才会被执行，而对于Webview的一些设置需要在页面加载成功前执行，比如某些重要页面需要在用户看到之前验证其身份、或是在Webview加载网页之前即显示定制的导航栏背景色。 珍岛客户端支持通过在传入的URL后添加参数的方式控制Webview的某些行为或显示效果。

示例

http://www.71360.com/fsask/index.html?fs_auth=true&fs_auth_appName=珍岛问问&fs_nav_bgcolor=c6a60000

参数说明

Webview跳转

回退页面

回退到上一个页面。

代码样例

FSOpen.webview.back({

});

方法名：FSOpen.webview.back
JS版本：2.0.0
客户端支持版本：5.4.0及以上

关闭当前页面

代码样例

FSOpen.webview.close({
    extras: {
        data: 1
    }
});

方法名：FSOpen.webview.close
JS版本：2.0.0
客户端支持版本：5.4.0及以上

调用参数说明：

打开页面

代码样例

FSOpen.webview.open({
    url: 'https://www.71360.com/jsapi-demo',
    onClose: function(extras) {
        alert('open new window');
    }
});

方法名：FSOpen.webview.open
JS版本：2.0.0
客户端支持版本：5.4.0及以上

调用参数说明：

Android物理键回退回调

仅Android适用。Android物理返回键返回上个页面时被调用。

代码样例

FSOpen.webview.onBackWebview({
    onBack: function() {
        alert('back to previous page！');
        FSOpen.webview.back();
    },
    onSuccess: function() {
        alert('现在请点击物理返回键');
    }
});

方法名：FSOpen.webview.onBackWebview
JS版本：2.0.0
客户端支持版本：5.4.0及以上

调用参数说明：

页面关闭回调

Webview窗口被关闭时回调，包括顶部栏关闭按钮及物Android物理返回键关闭。

代码样例

FSOpen.webview.onCloseWebview({
    onClose: function() {
        alert('我要关闭了！');
        FSOpen.webview.close();
    },
    onSuccess: function() {
        alert('现在请点击回退按钮退出当前页面');
    }
});

方法名：FSOpen.webview.onCloseWebview
JS版本：2.0.0
客户端支持版本：5.4.0及以上

调用参数说明：

屏幕控制

屏幕翻转

代码样例

FSOpen.webview.setOrientation({
    orientation: 'portrait'
});

方法名：FSOpen.webview.setOrientation
JS版本：2.0.0
客户端支持版本：5.4.0及以上

调用参数说明：

导航栏

设置导航栏标题

代码样例

FSOpen.webview.navbar.setTitle({
    title: '珍岛JSAPI'
});

方法名：FSOpen.webview.navbar.setTitle
JS版本：2.0.0
客户端支持版本：5.4.0及以上

调用参数说明：

设置导航栏问号链接

可在导航栏标题文本后显示一个问号图标，并定义其点击后的跳转链接。

代码样例

FSOpen.webview.navbar.setMiddleBtn({
    onClick: function() {
        FSOpen.webview.open({
            url: 'https://www.71360.com/aboutus/index.html'
        });
    }
});

方法名：FSOpen.webview.navbar.setMiddleBtn
JS版本：2.0.0
客户端支持版本：5.4.0及以上

调用参数说明：

设置导航栏左侧按钮

图示见设置导航栏问号链接

代码样例

FSOpen.webview.navbar.setLeftBtn({
    text: '关闭',
    onClick: function() {
        FSOpen.webview.close();
    }
});

方法名：FSOpen.webview.navbar.setLeftBtn
JS版本：2.0.0
客户端支持版本：5.4.0及以上

调用参数说明：

设置导航栏右侧按钮

可以在导航栏右侧显示1个或多个自定义按钮。超过两个按钮则会在更多菜单中显示这些按钮。

图示见设置导航栏问号链接  

代码样例

var btns = [
    {btnId: '1', icon: 'fav', text: '收藏'},
    {btnId: '2', icon: 'add', text: '添加'}
];
FSOpen.webview.navbar.setRightBtns({
    items: btns,
    onClick: function(resp) {
        // {btnId: '1'}
        alert('点击了按钮：' + btns[resp.btnId - 1].text);
    }
});

方法名：FSOpen.webview.navbar.setRightBtns
JS版本：2.0.0
客户端支持版本：5.4.0及以上

调用参数说明：

items中每个item对象参数说明

item对象中icon参数可选填值

onClick点击回调参数属性说明：

清除导航栏右侧所有按钮

注意此接口只会删除掉通过FSOpen.webview.navbar.setRightBtns设定的按钮，不会删除FSOpen.webview.navbar.showMenu设定的菜单。

代码样例

FSOpen.webview.navbar.removeRightBtns();

方法名：FSOpen.webview.navbar.removeRightBtns
JS版本：2.0.0
客户端支持版本：5.4.0及以上

显示"更多"菜单

显示一个珍岛提供的“更多”菜单，菜单中预置了一些常用的功能实现，比如收藏、转发到企信、转发到分享、转发到微信等。

通常开发者仅需自定义需要显示的菜单列表，无需再为每个功能提供实现，但如果有自己的特殊需求，也可以自定义实现各菜单的全局回调函数，详情可参考本文Webview-“更多”菜单回调章节。

代码样例

FSOpen.webview.navbar.showMenu({
    menuList: [
        'service:favorite',
        'share:toConversation',
        'share:toFeed',
        'separator',
        'share:toCRMContact',
        'share:toWXFriend',
        'share:toWXMoments',
        'share:toQQFriend',
        'share:viaMail',
        'share:viaSMS',
        'separator', //分隔符，可根据需要多次使用
        'page:refresh',
        'page:copyURL',
        'page:generateQR',
        'page:openWithBrowser'
    ]
});

方法名：FSOpen.webview.navbar.showMenu
JS版本：2.0.0
客户端支持版本：5.4.0及以上

调用参数说明：

menuItem说明：

隐藏"更多"菜单

代码样例

FSOpen.webview.navbar.hideMenu();

方法名：FSOpen.webview.navbar.hideMenu
JS版本：2.0.0
客户端支持版本：5.4.0及以上

“更多”菜单回调

通过FSOpen.webview.navbar.showMenu设置的“更多”菜单，在用户点击的时候会触发对应的全局回调处理。开发者可实现这些回调以自定义具体（转发）的内容信息。

“更多”菜单回调：转发到企信

代码样例

FSOpen.webview.menu.onShareToConversation({
    title: '珍岛逍客',
    desc: '移动办公 自在珍岛',
    link: 'http://www.71360.com',
    imgUrl: 'https://www.71360.com/static/img/index/logo.png?v=5.1.5',
    onSuccess: function(resp) {
        // 可以在这里做些分享数据统计
    },
    onFail: function(error) {
        if (error.errorCode == 40050) {
            alert('用户取消分享');
            return;
        }
        alert('操作失败，错误码：' + error.errorCode);
    }
});

方法名：FSOpen.webview.menu.onShareToConversation
JS版本：2.0.0
客户端支持版本：5.4.0及以上

调用参数说明：