状态栏大全-状态栏透明(沉浸式)、变色及全屏的区别

最新推荐文章于 2024-09-16 11:31:45 发布

hsany330

最新推荐文章于 2024-09-16 11:31:45 发布

阅读量1k

点赞数

原文链接：https://ask.dcloud.net.cn/article/1150

版权

手机的顶部状态栏，也就是信号、电量那条，有4种状态，分别是正常、变色、透明（也称沉浸式状态栏）、消失（也就是全屏）。
后3种特殊用法，具体见下：

状态栏变色

常见使用场景：如果title背景为纯色且显眼，一般会把状态栏的背景色也变成title的颜色，看起来大气，比如流应用中的网易新闻。

写法：
使用5+API plus.navigator.setStatusBarBackground）。

首页配置
首页需要在manifest.json文件中，plus->launchwebview下添加statusbar节点，并配置background的值（格式为#RRGGBB）。

若首页为secondwebview，则调整launchwebview为secondwebview即可。

终端支持：

Android5及以上系统支持；
iOS7.0及以上系统支持。

前景色处理：
当背景色调整后，如果调整不当，会造成前景的信号栏文字颜色与背景太相近，看不清前景，此时需要调整前景色。
前景色的使用限制更多些，只能设置黑或白，通过plus.navigator.setStatusBarStyle('dark');设前景为黑色，'dark'换成light则前景色变为白色。
同时前景色处理在终端支持方面：

Android5只有小米和魅族支持，Android6及以上所有安卓支持；
iOS7及以上支持

高度处理：此时webview高度没有全屏，webview高度+状态栏高度=手机屏幕高度。
也就是转场动画时，webview动画是不会通顶的，状态栏不会在转场时变化。

状态栏透明（沉浸式）

常见使用场景：如果页面顶部是图片，一般会把状态栏变成透明，此时同时会处理成滚动后恢复为纯色title，比如流应用中的36kr：

或者看视频https://v.qq.com/x/page/h0386sphgpt.html

写法：
Android平台设置沉浸式状态栏显示效果
 iOS平台设置沉浸式状态栏显示效果

终端支持：

Android4.4及以上系统支持；
iOS7.0及以上系统支持。
前景色处理：
与背景色调整相同，如果背景图颜色不当，会造成前景的信号栏文字颜色与背景太相近，看不清前景，此时需要调整前景色。
前景色的使用限制更多些，只能设置黑或白，通过plus.navigator.setStatusBarStyle('dark');设前景为黑色，'dark'换成light则前景色变为白色。
同时前景色处理在终端支持方面：
Android5只有小米和魅族支持，Android6及以上所有安卓支持；
iOS7及以上支持

高度处理：
注意，此时webview高度为全屏，状态栏高度为0，也就是webview高度=屏幕高度。
状态栏背景透明后前景图标覆盖在webview顶部。
尤其注意此时dom里涉及fix定位计算的元素，可能需要重新排高度。
在状态栏透明的情况下，转场动画时，webview动画是会通顶的，状态栏那里也会有条线左右移动。

其他注意：
沉浸式状态栏不支持动态调整，属于应用级，真机运行不生效，需要提交到云端打包后有效。
一个app设置了沉浸式，就意味着里面的每个webview都变成沉浸式。
这可能会造成很多页面都需要调整高度，此时有一种方案，就是在webview创建时，允许通过一个参数设置把这个webview的状态条再模拟显示出来，plus.webview.create('http://m.weibo.cn/u/3196963860', 'test', {statusbar:{background:"#D4D4D4"}})。这样设置后，webview的高度重新回到状态栏下方，不再顶到屏幕顶部。
此api从HBuilder8.1 alpha版起生效。

示例：
在hello mui里的nav bar示例中，提供了原生的渐变头和HTML的渐变头2种示例，大家可以参考。