DCloud_App_Array
DCloud_App_Array
  • 发布:2015-10-28 18:05
  • 更新:2019-01-07 15:31
  • 阅读:67605

如何动态兼容沉浸式状态栏模式

分类:HTML5+

HBuilder6.6.1版本已经完全支持沉浸式状态栏,可以下载最新版本HelloH5应用体验。
各平台配置参考:

  1. Android平台设置沉浸式状态栏显示效果
  2. iOS平台设置沉浸式状态栏显示效果

由于各系统版本的限制,沉浸式状态栏对系统有要求(Android4.4及以上、iOS7.0及以上),如果要兼容各系统版本,需要动态判断当前环境是否支持沉浸式状态栏以及系统状态栏的高度:

使用5+API

  • 判断当前环境是否支持沉浸式状态栏
    plus.navigator.isImmersedStatusbar()
    如果当前支持沉浸式状态栏则返回true,否则返回false。
  • 获取当前系统状态栏高度
    plus.navigator.getStatusbarHeight()
    获取系统状态栏高度,Number类型。
    其单位是逻辑像素值,即css中可直接使用的像素值,可能存在小数点。

实际用法参考HelloH5应用的“plus/doc.html”:

    // 创建加载内容窗口  
    var topoffset='45px';  
    if(plus.navigator.isImmersedStatusbar()){// 兼容immersed状态栏模式  
        // 获取状态栏高度并根据业务需求处理,这里重新计算了子窗口的偏移位置  
        topoffset=(Math.round(plus.navigator.getStatusbarHeight())+45)+'px';  
    }  
    // 使用偏移位置创建子窗口  
    wc=plus.webview.create(null,'doccontent',{top:topoffset,bottom:'0px',bounce:'vertical',bounceBackground:'#FFFFFF'});

通过userAgent判断
5+API需要在plusready事件后才能调用,通常此事件在DOM加载渲染后才会触发,无法再渲染前根据不同的状态来设置css。
为了解决此问题,在支持5+API运行环境的userAgent中特定字段Html5Plus/1.0后添加Immersed标识,如下:
"Html5Plus/1.0 (Immersed/30)"
其中Immersed/后的30表示状态栏的高度,单位为逻辑像素值。

可以使用正则表达式进行获取:

var immersed = 0;  
var ms=(/Html5Plus\/.+\s\(.*(Immersed\/(\d+\.?\d*).*)\)/gi).exec(navigator.userAgent);  
if(ms&&ms.length>=3){ // 当前环境为沉浸式状态栏模式  
    immersed=parseFloat(ms[2]);// 获取状态栏的高度  
}

immersed值如果大于0则表示当前环境支持沉浸式状态栏。
获取状态栏高度后,可以使用js动态修改DOM元素的css属性来设置样式,如设置界面头区域的顶部内边距为状态栏的高度(避免系统状态栏与界面头重叠),示例如下:

var t=document.getElementById('header');  
t&&t.style.paddingTop=immersed+'px';

具体项目中可根据界面设计,灵活使用immersed值来动态适配各种效果。
完整用法可参考HelloH5应用中的“js/immersed.js”

11 关注 分享
meijj522 老醒 rabet Trust fsyang 1***@QQ.COM 可苦可乐 雪之梦技术驿站 wenju 5***@qq.com 1***@qq.com

要回复文章请先登录注册

DCloud_App_Array

DCloud_App_Array (作者)

回复 吞天小猪 :
首页可以在plusready事件之后调用plus.webview.currentWebview().setStyle({top:"..px"})方法来动态调整自身的位置。
2015-11-10 12:50
吞天小猪

吞天小猪

回复 吞天小猪 :
初始化里面能设置偏移高度不?
2015-11-10 09:39
吞天小猪

吞天小猪

回复 DCloud_App_Array :
首页怎么预留状态栏的高度
2015-11-10 09:38
LFZ

LFZ

回复 DCloud_App_Array :
好的
2015-11-07 12:25
DCloud_App_Array

DCloud_App_Array (作者)

回复 LFZ :
Android无法修改状态栏上文字的字体颜色,其颜色受程序使用的主题影响(设置主题参考:http://ask.dcloud.net.cn/article/238),由于android的碎片化严重,不确定各rom在不同主题下的具体情况,需要真机测试显示效果。
iOS平台可设置两种样式,一种是白色文字样式,一种是黑色文字样式,参考:http://ask.dcloud.net.cn/article/33
2015-11-06 18:21
LFZ

LFZ

回复 DCloud_App_Array :
哦哦,那么系统状态栏的字体颜色是否可以改变
2015-11-06 16:49
DCloud_App_Array

DCloud_App_Array (作者)

回复 LFZ :
沉浸式状态栏模式实际上是webview的区域放大了,包括原来的系统状态栏区域,而系统状态栏是透明的,看到的就是webview上显示的内容。这时在webview上的布局需要考虑预留出系统状态栏的显示区域。
2015-11-06 16:31
LFZ

LFZ

打包测试了,状态栏颜色改变不了,加入web下拉刷新后,下拉刷新的“下拉刷新”提示被挡住了一半。
2015-11-05 17:28
一样一样

一样一样

回复 一样一样 :
真机测试可以获取到
2015-11-03 13:28
一样一样

一样一样

plus.navigator.getStatusbarHeight() 打包运行获取的一直是0,启动页面会有状态栏显示,
2015-11-03 13:27