配置文件详解
主配置文件app.json
主配置文件位于主目录中,用于进行全局配置。包括页面文件的路径、窗口表现、设置网络超时时间、设置多tab等
下面通过微信最初自带小程序来学习
{ "pages":[ "pages/index/index", "pages/logs/logs" ], "window":{ "backgroundTextStyle":"light", "navigationBarBackgroundColor": "#fff", "navigationBarTitleText": "WeChat", "navigationBarTextStyle":"black" } }
这是微信小程序自带的配置文件app.json
pages
"pages":[]用来定义小程序中所用到的界面,是一个数组,上面代码中有两个值位于pages/index下的index文件和pages/logs下的logs文件
window
"window":{}文件用来定义窗口的表现形式,例如"navigationBarTitleText": "WeChat",表示设置窗口标题为WeChat
配置窗口状态
backgroundColor:用来设置窗口背景颜色,使用十六进制的RGB方式设置
backgroundTextStyle:设置下拉背景字体,loading图的样式,只支持设置为"dark""light",默认为"dark"
navigationBarBackgroundColor:用来设置窗口的背景颜色,采用十六进制的RGB方式设置
enablePullDownRefresh:设置下拉是否刷新
navigationBarTitleStyle:导航栏标题颜色
tabBar
配置窗口底部tabBar
"tabBar":{ "color":"#dddddd", "selectedColor":"#3cc51f", "borderStyle":"black", "backgroundColor":"#ffffff", "list":[{ "pagePath":"page/component/index", "iconPath":"image/icon_component.png", "selectedIconPath":"image/icon_component_HL.png", "text":"组件", },{ "pagePath":"page/API/index/index", "iconpath":"image/icon_API.png", "selectedIconPath":"image/icon_API_HL.png", "text":"接口" } ] }
tabBar中有5个属性可以设置
- color:设置tab未激活状态文字的颜色
- selectedColor:设置tab激活文字状态的颜色
- boredStyle:设置tabBar上边框的颜色,白与黑
- backgroundColor:设置tab背景的颜色
- list:这是一个数,设置tab列表项,最少两个最多五个。list有四个属性值:
- text:设置tab上显示的文字
- iconPath:tab处于未激活状态时的图片路径,icon照片大小限制为40kb
- pagePath:设置触按tab时跳转的路径
其他配置
networkTimeout
微信小程序中有多种网络连接,可以通过参数"networkTimeout"设置网络请求的超时时间。
"networkTimeout": { "request": 20000, "connectSocket": 20000, "uploadFile": 20000, "downloadFile": 20000 }
- request:设置网络请求接口的超时时间
- connectSocket设置wx.connectSocket接口网络请求的超时时间
- downloadFile:设置wx.downloadFile下载文件接口超时时间
- uploadFile:上传文件接口超时时间
页面配置文件
主配置文件配置项很多但是是全局的,每个页面都可以使用。但是窗口标题每个页面都有不同的标题,每个页面也需要一个页面配置文件来对这些项目进行配置。
页面配置只能设置主配置文件中window的配置项内容,无需写window键,页面配置会自动覆盖主配置中的内容。