更新日期:     浏览次数:

1. 界面相关

本页介绍了和轻应用界面设置相关的JS-API方法,开发者可以根据应用的需求进行相应的配置。云之家会不断开放更多能力以满足更多应用个性化的开发需求。如果您有什么建议,欢迎在云之家开发者交流社区留言反馈,我们会根据您的需求进行优化。

1.1. 隐藏或者设置页面标题

调用代码:

qing.call('hideWebViewTitle');//隐藏页面标题
qing.call('setWebViewTitle',{'title':'申请加入群聊'});//设置页面标题并显示

参数说明:

参数名称 数据类型 必选 说明
title string 需要设置的标题

回调说明:

1.2. 关闭轻应用界面

调用代码:

//0.9.5及以上支持
qing.call('closeWebView');

参数说明:

回调说明:

1.3. 自定义右上角弹出菜单

调用代码:

//0.9.6及以上支持
qing.call('createPop', {
    'popTitle': String,
    'popTitleCallBackId': String,
    'items': [
        {
            'text': '自定义条目1',
            'callBackId': 'callback1'
        },
        {
            'text': '自定义条目2',
            'callBackId': 'callback2'
        }
    ],
    'menuList': ['forward', 'refresh', 'share', 'openWithBrowser'],
    'shareData': {
        'isShowExt': '转发时是否显示商务伙伴,true or false,默认为true',
        'title': '分享或者转发的标题',
        'url': '分享的链接,若空则取当前的url',
        'description': '分享或者转发的内容',
        'appLogo': '轻应用Logo,base64数据,大小不要超过32k,分辨率推荐198*198,图片格式推荐使用jpg',
        'appName': '轻应用名称'
    },
    'success': function (resp) {
        if (resp.success == true || resp.success == 'true') {
            var callBackId = resp.data ? resp.data.callBackId : '';
            if (callBackId == 'callback1') {
                callback1();
            }
        }
    }
});

function callback1() {
    alert('callback1')
}

参数说明:

参数名称 数据类型 必选 说明
popTitle string 右上角弹出菜单名称,只支持最
多4位中文字符,超出部分会截
断显示(不传入popTitle,如果最
后传入的有效条 目数大于0,则会
默认显示云之家”更多”图标,如果
有效条目数为0,则右上角不显示任何内容)
popTitleCallBackId string 点击右上角回调ID
items array(object{'text':String,'callBackId':'String'}) 自定义菜单条目(text:菜单条目文本、callBackId:回调ID)
menuList array(string) 系统菜单条目,目前支持share(分享)、
refresh(刷新)、openWithBrowser
(在浏览器中打开)、forward(转发)
shareData object 分享或者转发的内容

回调说明:

注意:

  1. 自定义菜单条目items数量和系统菜单条目menuList数量加起来不超过7条,如超过则优先显示系统菜单条目(比如items数量为5,menuList数量为4,则显示items前3条加menuList里的4条);
  2. 菜单显示顺序为优先显示自定义菜单条目,然后显示系统菜单条目,系统条目按JS方法传入的menuList顺序来显示;

1.4. 关闭右上角弹出菜单

调用代码:

//0.9.6及以上支持
qing.call('closePop');

参数说明:

回调说明:

1.5. 自定义返回按钮事件

调用代码:

//0.9.11及以上支持
qing.call('defback', {
    success: function () {
        alert('点击了返回按钮');
        if (history.length <= 1) { //顶级页面,则关闭当前Web
            qing.call('closeWebView');
        } else {
            history.back();
        }
    }
});

参数说明:

回调说明:

1.6. 旋转界面

调用代码:

//0.9.11及以上支持
qing.call('rotateUI', {
    'orientation':'landscape'
});
参数名称 数据类型 必选 说明
orientation string 屏幕方向:"landscape"表示横屏,"portrait"表示竖屏

回调说明:无

1.7. 弹出Toast提示框

qing.call('toast', {
    msg: '提示信息'
})
参数名称 数据类型 必选 说明
msg string 提示信息

1.8. 设置WebView反弹(仅iOS)

qing.call('setBounce', {
    enable: 0
});
参数名称 数据类型 必选 说明
enable int 是否启用反弹效果,0: 禁止,1: 允许

1.9. 适配iPhone X底部偏移量

qing.call('setWebBottomInset', {
    show: true
});
参数名称 数据类型 必选 说明
show boolean 底部是否增加34px偏移量以适应iphoneX

1.10. 监听页面转入后台/转入前台事件

qing.on('appear', function (e) {
    alert('页面转入前台')
})

qing.on('disappear', function (e) {
    alert('页面转入后台')
})

results matching ""

    No results matching ""