阅读(604) (11)

百度小程序全局配置

2018-07-07 15:44:26 更新

配置界面,路径


可以通过配置app.json文件,设置SWAN的界面,路径,多TAB等。

app.json配置项列表如下:

属性 类型 必填 描述
网页 {String,Array} 设置页面路径
窗口 目的 设置页面展现
示例:
{
	"pages": [
		"pages/index/index",
		"pages/detail/detail"
	],
	"window": {
		"navigationBarTitleText": "Demo"
	}
}

pages


pages接受一个数组,每一项都是一个字符串,指定SWAN App都有哪些页面。每一项代表页面的[路径+文件名],数组第一项代表SWAN初始页面。

SWAN中新增或减少页面的话,需要在pages中进行配置。

配置项中不需要加文件后缀名,SWAN会自动解析。

如,开发目录为:

pages/

	pages/index/index.swan

	pages/index/index.css

	pages/index/index.js

	pages/detail/detail.swan

	pages/detail/detail.css

	pages/detail/detail.js

app.js

app.json

app.css

则需要在app.json中书写:

{
	"pages":[
		"pages/index/index",
		"pages/detail/detail"
	]
}

window


用于设置SWAN的状态栏,导航条,标题,窗口背景色。

属性 类型 必填 描述
navigationBarBackgroundColor HexColor #000000 导航栏背景颜色,如“#000000”
navigationBarTextStyle String
white
导航栏标题颜色,目前仅支持黑/白
navigationBarTitleText String
导航栏标题文字内容
backgroundColor
HexColor #FFFFFF 背景颜色
backgroundTextStyle String
dark
下拉背景字体,loading图的样式,仅支持暗/光
enablePullDownRefresh Boolean
false
是否开启下拉刷新
onReachBottomDistance Number
50 页面上拉触底事件触发时距页面底部距离,单位为px
示例:
{
	"window":{
		"navigationBarBackgroundColor": "#ffffff",
		"navigationBarTextStyle": "black",
		"navigationBarTitleText": "swan接口功能演示",
		"backgroundColor": "#eeeeee",
		"backgroundTextStyle": "light"
	}
}

配置全局数据


app.js中存放全局的JS逻辑。

示例:

App({
	onLaunch: function () {
		console.log('SWAN launch');
	},
	onShow: function () {
		console.log('SWAN展现');
	},
	onHide: function () {
		console.log('SWAN当前处于后台');
	},
	onError: function () {
		console.log('SWAN发生错误');
	},
	globalData: 'SWAN'
});

SWAN生命周期


属性 类型 描述 触发时机
onLaunch Function
SWAN初始化的生命周期函数 当SWAN App初始化完成时,会触发onLaunch(全局只触发一次)
onShow
Function
SWAN App展示时调用的生命周期函数 SWAN App从后台进入前台,触发onShow
onHide Function
SWAN App隐藏时调用的生命周期函数 SWAN App从前台进入后台,触发onHide
onLoad
Function
监听页面加载的生命周期函数 SWAN App页面加载完成,触发onLoad
onReady Function
监听页面初次渲染完成的生命周期函数 SWAN App页面渲染完成,触发onReady
onunload Function
监听页面卸载的生命周期函数 页面卸载,触发onUnload
onerror Function
错误监听函数 当SWAN App发生错误时,会触发