配置界面,路径


可以通过配置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发生错误时,会触发