uni-app学习笔记十九--pages.json全局样式globalStyle设置

pages.json 页面路由

pages.json 文件用来对 uni-app 进行全局配置,决定页面文件的路径、窗口样式、原生的导航栏、底部的原生tabbar 等。

导航栏高度为 44px (不含状态栏),tabBar 高度为 50px (不含安全区)。

它类似微信小程序中app.json页面管理 部分。注意定位权限申请等原属于app.json的内容,在uni-app中是在manifest中配置。

page.json配置项列表

属性 类型 必填 描述 平台兼容
globalStyle Object 设置默认页面的窗口表现
pages Object Array 设置页面路径及窗口表现
easycom Object 组件自动引入规则 2.5.5+
tabBar Object 设置底部 tab 的表现
condition Object 启动模式配置
subPackages Object Array 分包加载配置 H5 不支持
preloadRule Object 分包预下载规则 微信小程序
workers String Worker 代码放置的目录 微信小程序
leftWindow Object 大屏左侧窗口 H5
topWindow Object 大屏顶部窗口 H5
rightWindow Object 大屏右侧窗口 H5
uniIdRouter Object 自动跳转相关配置,新增于HBuilderX 3.5.0
entryPagePath String 默认启动首页,新增于HBuilderX 3.7.0 微信小程序、支付宝小程序

本篇先来学习 globalStyle

globalStyle用于设置应用的状态栏、导航条、标题、窗口背景色等。下面介绍下它几个常用的属性配置**(PS:不同的小程序,配置属性会略有差异,详情请查看官方文档)**:

1.navigationBarTextStyle:导航栏标题颜色及状态栏前景颜色,仅支持 black/white,默认为black;

2.navigationBarTitleText:导航栏标题文字内容;

3.navigationBarBackgroundColor:导航栏背景颜色(同状态栏背景色);

4.backgroundColor:下拉显示出来的窗口的背景色;

5.backgroundTextStyle:下拉 loading 的样式,仅支持 dark / light;

6.enablePullDownRefresh:是否开启下拉刷新;

7.onReachBottomDistance:页面上拉触底事件触发时距页面底部距离,单位只支持px。

页面上拉触底事件的使用:

javascript 复制代码
<script setup>
 import {onReachBottom} from "@dcloudio/uni-app"
 onReachBottom(()=>{
	 console.log("触底加载...")
 })
</script>

更多信息, 官方文档详见pages.json 页面路由 | uni-app官网

相关推荐
weixin_446260852 小时前
AVA-Encoder:面向智能体原生视频表征学习框架
学习·音视频
DeviceHub2 小时前
硬件工程师选型笔记:ALPS SKPMAPE010 与 Tonevee TS-3025 贴片轻触开关 PIN TO PIN 评估指南
笔记
吃好睡好便好2 小时前
说说口罩的佩戴
学习·生活·口罩
fīɡЙtīиɡ ℡3 小时前
大模型结构化输出
人工智能·学习
疯狂打码的少年3 小时前
【数据结构】二叉树的性质(五大性质+计算)
数据结构·笔记·算法
Dave1205463 小时前
Day17:Agent Memory高级设计——短期记忆、长期记忆与向量语义记忆
人工智能·学习
小唔w4 小时前
2026年AI培训行业观察:主流学习渠道一览
人工智能·学习
Capricorn19884 小时前
知芽研究问题看板无法推进?从孵化区到笔记的机制排查指南
大数据·论文阅读·人工智能·笔记·学习方法·论文笔记
闪闪发亮的小星星4 小时前
相机脱靶量VS精跟踪精度
笔记
Nan_Shu_6144 小时前
学习:MapVGL 地理信息可视化
学习