From 4ed25b145afd27c02fcaf2e4251f1187acfd1e66 Mon Sep 17 00:00:00 2001 From: wanganxp Date: Sat, 2 Mar 2024 20:27:46 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E7=8A=B6=E6=80=81=E6=A0=8F?= =?UTF-8?q?=E8=83=8C=E6=99=AF=E8=89=B2=E5=92=8Cpages.json=E9=A2=9C?= =?UTF-8?q?=E8=89=B2=E9=99=90=E5=88=B6=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/api/set-navigation-bar-color.md | 4 +++- docs/collocation/pagesjson.md | 7 +++---- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/api/set-navigation-bar-color.md b/docs/api/set-navigation-bar-color.md index a85521c0..ae060a71 100644 --- a/docs/api/set-navigation-bar-color.md +++ b/docs/api/set-navigation-bar-color.md @@ -2,7 +2,9 @@ -即便pages.json里没有配置NavigationBar,如需修改状态栏的前景背景,也需要本API。 +注意当pages.json中设置导航栏为custom时: +1. 状态栏的背景色将恒为透明。此时无法通过本API设置状态栏背景色。开发者可自行在状态栏区域放置view,设置背景色。 +2. 本API设置前景色frontColor时,会修改状态栏的前景色。 diff --git a/docs/collocation/pagesjson.md b/docs/collocation/pagesjson.md index 96bfb02e..9cf2fefb 100644 --- a/docs/collocation/pagesjson.md +++ b/docs/collocation/pagesjson.md @@ -19,8 +19,6 @@ hello uni-app x有相关示例,参考: - 自定义tabbar:[源码参考](https://gitcode.net/dcloud/hello-uni-app-x/-/tree/master/pages/template/custom-tab-bar) 插件市场也有其他封装好的插件,请自行搜索。 -> 本文只包括 uni-app x 对 pages.json 支持情况。完整配置项详见 [pages.json 页面路由](https://uniapp.dcloud.net.cn/collocation/pages.html) - ## 配置项列表 @@ -107,9 +105,10 @@ pages节点里注册页面,数据格式是数组,数组每个项都是一个 **Tips** - 状态栏 * 手机顶部状态栏的背景色、前景色(white/black)与navigationBarBackgroundColor和navigationBarTextStyle相同 - * 当navigationStyle设为custom时,原生导航栏不显示。此时需要注意系统状态栏背景色会受到[globalStyle](#pages-globalstyle)中navigationBarBackgroundColor配置的影响,可能会遮挡自定义导航栏,此情况下可以在页面配置中将navigationBarBackgroundColor设为transparent,即设置系统状态栏透明。 + * 小程序平台,pages.json中各个颜色的设置仅支持普通的16进制数值。App和Web支持设为transparent,即透明。 * 如需动态设置状态栏颜色,使用api [uni.setNavigationBarColor](../api/set-navigation-bar-color.md) - * 注意不同手机的状态栏高度并不相同,如需获取本机的状态栏高度,使用api [uni.getWindowInfo](../api/get-window-info.md) + * 当navigationStyle设为custom时,原生导航栏不显示。此时需要注意系统状态栏背景色恒为透明。 + * 注意不同手机的状态栏高度并不相同,如需获取本机的状态栏高度,使用api [uni.getWindowInfo](../api/get-window-info.md) 或 css变量 [--status-bar-height](../css/common/variable.md) - 下拉刷新 * pages.json中下拉刷新是页面级配置,方便使用但灵活度有限。 * 如需自定义下拉刷新,请使用[scroll-view](../component/scroll-view.md)或[list-view](../component/list-view.md)的下拉刷新。 -- GitLab