Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
DCloud
unidocs-uni-app-x-zh
提交
4ed25b14
U
unidocs-uni-app-x-zh
项目概览
DCloud
/
unidocs-uni-app-x-zh
通知
144
Star
2
Fork
33
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
9
列表
看板
标记
里程碑
合并请求
11
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
U
unidocs-uni-app-x-zh
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
9
Issue
9
列表
看板
标记
里程碑
合并请求
11
合并请求
11
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
提交
4ed25b14
编写于
3月 02, 2024
作者:
W
wanganxp
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
更新状态栏背景色和pages.json颜色限制说明
上级
b7b7feb6
变更
2
隐藏空白更改
内联
并排
Showing
2 changed file
with
6 addition
and
5 deletion
+6
-5
docs/api/set-navigation-bar-color.md
docs/api/set-navigation-bar-color.md
+3
-1
docs/collocation/pagesjson.md
docs/collocation/pagesjson.md
+3
-4
未找到文件。
docs/api/set-navigation-bar-color.md
浏览文件 @
4ed25b14
...
...
@@ -2,7 +2,9 @@
<!-- UTSAPIJSON.setNavigationBarColor.description -->
即便pages.json里没有配置NavigationBar,如需修改状态栏的前景背景,也需要本API。
注意当pages.json中设置导航栏为custom时:
1.
状态栏的背景色将恒为透明。此时无法通过本API设置状态栏背景色。开发者可自行在状态栏区域放置view,设置背景色。
2.
本API设置前景色frontColor时,会修改状态栏的前景色。
<!-- UTSAPIJSON.setNavigationBarColor.param -->
...
...
docs/collocation/pagesjson.md
浏览文件 @
4ed25b14
...
...
@@ -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)
## 配置项列表
<!-- PAGESJSON.pages.description -->
...
...
@@ -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
)
的下拉刷新。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录