框架主体文件
*框架主体文件由app.json、app.js、app.wxss构成
- app.json:小程序公共设置,配置小程序全局设置。
- app.js:小程序逻辑文件,主要用于注册小程序全局实例,编译时会和其他逻辑界面文件打包成一份JavaScript文件。
- app.wxss:小程序公共样式表,对所有页面的布局都有效。
app.json 和 app.js是必须存在的,app.wxss不是必须创建的
app.json(配置文件)
{
//页面路径设置
"pages" : [].
//默认页面的窗口设置
"window" : {},
//底部tab设置
"tabBar" : {},
//设置网络请求API的超时时间
"networkTimeout" : {},
//是否为debug模式
"debug" : false
}
pages:设置页面路径,必填项
pages负责注册小程序页面,必须填写,每一项由页面“路径+文件名”组成
{
"pages" : [
"mypages/index/index",
"mypages/page2/mypagefilename",
"otherpages/index/index"
]
}
- pages数组中页面路径不需要填写文件后缀名,渲染页面时框架会自动寻找路径.json,.js,.wxml,.wxss四个文件进行整合。pages配置数组的第一项代表小程序的初始页面。
window配置
window负责设置小程序的状态栏、导航条、标题、窗口背景色等系统样式。
- navigationBarBackgroundColor:导航栏标题颜色,值为HexColor(十六进制颜色值),如:“#ff83fa” , 默认值为#000000
- navigationBarTextStyle:导航栏标题颜色,仅支持black/white,默认值为white
- navigationBarTitletext:导航栏标题文字内容
- backgroundColor:窗口背景色,值为HexColor
- backgroundTextStyle:下拉背景字体、Loading图的样式,仅支持dark/light
- enablePullDownRefresh:是否开启下拉刷新,默认为false
tabBar配置
当程序顶部或底部需要菜单栏时,我们可以通过配置tabBar快速实现,tabBar是个非必填项
-
color:tab上的文字默认颜色,值为HexColor,必选项
-
selectedColor:tab上的文字被选中时的颜色,值为HexColor,必选项
-
backgroundColor:tab上的背景色,值为HexColor,必选项
-
borderStyle:tabBar上边框的颜色,仅支持black/white,默认值为black
-
list:tab的列表,必填项,其值为一个数值,最少2个,最多5个tab,数组中每一个项是一个对象,代表一个tab的相关配置。
pageath:页面路径,必须在pages中先定义,必填项 text:tab上按钮的文字,必填项 iconPath:tab上icon图片的相对路径,icon的大小限制为40kb,必填项 selectedIconPath:选中时图片的相对路径,icon的大小限制为40kb,必填项 position:tab在顶部或底部显示,可选值为botton、top、默认值为botton。
networkTimeout配置
小程序中各种网阔请求API的超时时间只能通过networkTimeout统一设置,不能在API中单独设置
- request:设置wx.request的超时时间,单位毫秒
- connectSocket:设置wx. connectSocket的超时时间,单位毫秒
- uploadFile:设置wx.uploadFile的超时时间,单位毫秒
- downloadFile:设置wx. downloadFile的超时时间,单位毫秒
debug配置
此配置项控制是否开启debug模式,默认是关闭的。开启debug模式后,在开发者工具的控制面板、调试信息以info的形式输出
app.js(小程序逻辑)
小程序中逻辑文件分为页面逻辑文件和小小程序逻辑文件,app.js便是小程序逻辑文件,在这个文件中,我们可以通过App()函数注册小程序生命周期函数、全局方法和全局变量,以注册的小程序实例可以在其他逻辑代码中通过getApp()获取。
- 注册小程序
App()函数用于注册一个小程序,参数为一个Object对象,在这个参数对象中我们可以注册自定义方法和属性供全局使用
app.wxss(全局样式)
app.wxss是全局样式,对项目中每一个页面都有效,可以将一些系统级别的统一样式风格写入这个文件,页面渲染时,框架页中的.wxss文件样式会覆盖app.wxss中相同的选择器样式。