【微信小程序】-- 全局配置 -- window - 导航栏（十五）

• 所属专栏：【微信小程序开发教程】

• 作  者：我是夜阑的狗

• 个人简介：一个正在努力学技术的CV工程师，专注基础和实战分享 ，欢迎咨询！

• 欢迎大家：这里是CSDN，我总结知识的地方，喜欢的话请三连，有问题请私信

---

前言

  大家好，又见面了，我是夜阑的狗，本文是专栏【微信小程序开发教程】专栏的第15篇文章;
  今天开始学习微信小程序的第九天，开启新的征程，记录最美好的时刻，每天进步一点点。
  专栏地址：【微信小程序开发教程】， 此专栏是我是夜阑的狗微信小程序开发过程的总结，希望能够加深自己的印象，以及帮助到其他的小伙伴。
  如果文章有什么需要改进的地方还请大佬不吝赐教。

---

一、全局配置

  前面已经介绍了WXSS模板语法-全局样式和局部样式，通过栗子学习了WXSS模板语法样式之间的覆盖。接下来就来讲解一下小程序的全局配置。话不多说，让我们原文再续，书接上回吧。

1、全局配置文件及常用的配置项

&ems; 小程序根目录下的 app.json 文件是小程序的全局配置文件，决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。常用的配置项如下：

配置项	说明
pages	记录当前小程序所有页面的存放路径
window	全局设置小程序窗口的外观
tabBar	设置小程序底部的 tabBar 效果
style	是否启用新版的组件样式

&ems;  前面已经学习过了pages和style属性，现在就来学习另外两个重要属性：window、tabBar。

二、window

  用于设置小程序的状态栏、导航条、标题、窗口背景色。

1、小程序窗口的组成部分

  小程序窗口一般由导航栏区域和页面主体区域组成，如下图所示，1 部分表示为导航栏区域，2 部分表示为页面的主体区域，用来显示wxml中的布局，1 和 2 之间还有一个背景区域，默认不可见，只有下拉才能显示。

   window配置项只能对导航栏和背景区域进行配置，不能对页面的主体区域进行配置。

2、window 节点常用的配置项

   根据 window 节点配置项的作用，可以对 window 中的属性进行分类：

• 第一类、配置导航栏相关样式，以 navigation 开头；
• 第二类、配置窗口背景相关样式，以 background 开头；
• 第三类、控制页面效果；

   常用配置项如下表所示：

属性名	类型	默认值	说明
navigationBarTitleText	String	字符串	导航栏标题文字内容
navigationBarBackgroundColor	HexColor	#000000	导航栏背景颜色，如 #000000
navigationBarTextStyle	String	white	导航栏标题颜色，仅支持 black / white
backgroundColor	HexColor	#ffffff	窗口的背景色
backgroundTextStyle	String	dark	下拉 loading 的样式，仅支持 dark / light
enablePullDownRefresh	Boolean	false	是否全局开启下拉刷新
onReachBottomDistance Number		50	页面上拉触底事件触发时距页面底部距离，单位为px

3、设置导航栏的标题

   刚创建微信小程序的时候，导航栏上的标题都是默认为 WeChat。现在要将默认标题修改为 我是夜阑的狗 ，具体操作为

app.json -> window -> navigationBarTitleText

app.json

{
  "window":{
    "backgroundTextStyle":"light",
    "navigationBarBackgroundColor": "#fff",
    "navigationBarTitleText": "我是夜阑的狗", 
    "navigationBarTextStyle":"black"
  },
}

   通过修改 window 中的属性来修改导航栏上的标题，实际效果如下图所示：

4、设置导航栏的背景色

   修改完导航栏上的标题之后，接下来还可以对导航栏的背景颜色进行修改。现在要将导航栏背景色从默认颜色 #fff 修改为 #2b4b6b，具体操作为

app.json -> window -> navigationBarBackgroundColor

app.json

{
  "window":{
    "backgroundTextStyle":"light",
    "navigationBarBackgroundColor": "#ff0000",
    "navigationBarTitleText": "我是夜阑的狗", 
    "navigationBarTextStyle":"black"
  },
}

   通过修改 window 中的属性来修改导航栏背景颜色，实际效果如下图所示：

   注意：这个导航栏背景颜色只支持十六进制的颜色值，不支持文本颜色值，例如：red、green等。

5、设置导航栏的标题颜色

   看到上面的效果图，红色背景黑色标题看起来很不美观，所以可以对导航栏的标题文本颜色进行修改。现在要将导航栏标题颜色从默认 black 修改为 white，具体操作为

app.json -> window -> navigationBarTextStyle

app.json

{
  "window":{
    "backgroundTextStyle":"light",
    "navigationBarBackgroundColor": "#ff0000",
    "navigationBarTitleText": "我是夜阑的狗", 
    "navigationBarTextStyle":"white"
  },
}

   通过修改 window 中的属性来修改导航栏标题颜色，很明显视觉效果好了很多（个人观感），实际效果如下图所示：

   注意： navigationBarTextStyle 的可选值只有 black 和 white

---

总结

  感谢观看，这里就是全局配置 window 中的导航栏设置介绍，如果觉得有帮助，请给文章点个赞吧，让更多的人看到。

  也欢迎你，关注我。

  原创不易，还希望各位大佬支持一下，你们的点赞、收藏和留言对我真的很重要！！！ 最后，本文仍有许多不足之处，欢迎各位认真读完文章的小伙伴们随时私信交流、批评指正！下期再见。

更多专栏订阅:

• 【LeetCode题解（持续更新中）】
• 【Java Web项目构建过程】
• 【微信小程序开发教程】
• ⚽ 【JavaScript随手笔记】
• 【大数据学习笔记（华为云）】
• 【程序错误解决方法（建议收藏）】
• 【软件安装教程】

订阅更多，你们将会看到更多的优质内容！！