UniApp中的pages.json 和 tabBar

一、pages.json 和 tabBar 案例

pages.json作用:配置页面路由、导航栏、tabBar等页面类信息

静态资源存放要求:必须放在static目录中才能被打包

页面存放位置:业务页面必须放在pages目录下

  1. 修改 pages.json
    1)pages配置

路径写法:只需写路径不需要.vue后缀,如"pages/index/index"

启动页规则:pages数组中第一项表示应用启动页

标题修改:通过navigationBarTitleText属性修改页面标题

2)页面样式配置

导航栏颜色:使用navigationBarBackgroundColor属性修改

文字颜色:通过navigationBarTextStyle设置,仅支持white/black两种

全局背景色:backgroundColor属性控制页面背景颜色

3)全局样式配置

globalStyle作用:统一修改所有页面的窗口表现

颜色取值技巧:可使用截图工具吸取颜色值

样式继承规则:页面样式会覆盖全局样式配置

  1. 新建页面

必要操作:必须勾选"在pages.json中注册"选项

目录规范:会自动创建同名目录存放页面文件

标题预设:可在创建时直接设置navigationBarTitleText

  1. 配置 tabBar

1)配置一项错误示例

最少项数:list数组必须包含至少2个配置项

错误提示:编译时会明确提示缺少配置项数量

2)配置两项成功示例

pagePath:必须指向pages目录下的页面路径

text规范:建议控制在2-4个汉字长度

图标路径:需使用static目录下的资源路径

3)配置图标

两种状态:需同时配置iconPath和selectedIconPath

颜色搭配:selectedColor应与主题色保持一致

尺寸建议:推荐使用81px*81px的图标尺寸

  1. 修改 manifest.json

APP ID位置:在微信小程序配置项中填写

调试限制:未配置APP ID时只能使用游客模式

多端适配:可分别配置不同平台的打包信息

二、内容总结

三大配置块:pages路由、globalStyle全局样式、tabBar底部导航

目录规范:

页面→pages目录

静态资源→static目录

调试准备:manifest.json中必须配置有效的APP ID

样式优先级:页面样式 > 全局样式 > 默认样式

三、知识小结

知识点

核心内容

考试重点/易混淆点

难度系数

pages.json文件作用

配置页面路由、导航栏、tab等页面类信息

路由配置必须包含完整路径但不写文件后缀

⭐⭐

全局样式配置

通过globalStyle修改导航栏背景色、文字颜色等

文字颜色仅支持黑白两色

tabBar配置规范

需包含至少2个tab项,每个tab需配置pagePath和text

路径错误会导致页面无法跳转

⭐⭐⭐

静态资源存放规则

图标等资源必须放在static目录

非static目录资源打包时会丢失

⭐⭐⭐⭐

页面创建流程

在pages目录新建页面时需勾选自动注册路由

未注册页面无法被访问

⭐⭐

manifest.json配置

小程序项目需在此文件配置APPID才能真机预览

安卓/iOS配置可忽略

⭐⭐⭐

相关推荐
codingWhat2 天前
小程序里「嵌」H5:一套完整可落地的 WebView 集成方案
前端·uni-app·webview
小时前端3 天前
微信小程序选不了本地文件?用 web-view + H5 一招搞定
前端·微信小程序·uni-app
Mr_li3 天前
给 Vue 开发者的 uni-app 快速指南
vue.js·uni-app
anyup4 天前
🔥2026最推荐的跨平台方案:H5/小程序/App/鸿蒙,一套代码搞定
前端·uni-app·harmonyos
Mintopia4 天前
Vue3 项目如何迁移到 uni-app x:从纯 Web 到多端应用的系统指南
uni-app
Mintopia4 天前
uni-app x 发展前景技术分析:跨端统一的新阶段?
uni-app
不爱说话郭德纲5 天前
告别漫长的HbuilderX云打包排队!uni-app x 安卓本地打包保姆级教程(附白屏、包体积过大排坑指南)
android·前端·uni-app
HashTang7 天前
【AI 编程实战】第 12 篇:从 0 到 1 的回顾 - 项目总结与 AI 协作心得
前端·uni-app·ai编程
JunjunZ7 天前
uniapp 文件预览:从文件流到多格式预览的完整实现
前端·uni-app
郑州光合科技余经理7 天前
代码展示:PHP搭建海外版外卖系统源码解析
java·开发语言·前端·后端·系统架构·uni-app·php