该文章意在汇总整理 app.js 的配置,方便日常开发中查阅。
详细教程请参考 app.js - wap2app教程
App
App(appConfig);
参数说明 | 参数 | 类型 | 说明 | 更多 |
---|---|---|---|---|
options | Object | 全局参数配置 | * | |
onLaunch | Function | 生命周期函数,监听 wap2app 应用初始化。 | wap2app 应用初始化完成时触发,全局只触发一次。 | |
onShow | Function | 生命周期函数,监听 wap2app 应用显示。 | 当 wap2app 应用从后台进入前台显示时触发。 | |
onHide | Function | 生命周期函数,监听 wap2app 应用隐藏。 | 当 wap2app 应用从前台进入后台时触发。 |
Tips
当用户按了设备 Home 键,wap2app 应用并不会立即被销毁,而是进入了后台运行。当再次打开 wap2app 应用时,会从后台进入前台。
appConfig -> options 参数说明 | 参数 | 类型 | 说明 | 更多 |
---|---|---|---|---|
debug | Boolean | 是否输出日志,默认为 false。 | 通过 HBuilder 真机运行调试时,如果设置为 true,则在控制台输出日志信息。 |
Page
Page(id, pageConfig);
参数说明 | 参数 | 类型 | 说明 | 更多 |
---|---|---|---|---|
id | String | webview 的 id | 该值取自 sitemap.json 中配置 page 对应的 webviewId | |
pageConfig | Object | 页面参数配置 | * |
pageConfig 参数说明 | 参数 | 类型 | 说明 | 更多 |
---|---|---|---|---|
onShow | Function | 生命周期函数,监听 webview 的显示。 | 对应的 webview 显示时触发 | |
onClose | Function | 生命周期函数,监听 webview 的关闭。 | 对应的 webview 关闭时触发 |
运行环境
需要注意的是,以上函数中的 JavaScript 的代码,并不是在首页或者某个 webviewe 中执行。
所以当 JavaScript 代码中涉及到最某个特定 webview 中的内容进行操作时,需要获取 webview 通过 evalJS 方法来执行。
例如,从详情页返回时,希望刷新列表页。在 app.js 中,注册 detail 页面的配置。
Page('detail', {
onClose: function() {
// 刷新列表
var listWebview = plus.webview.getWebviewById('list');
if(listWebview) {
listWebview.evalJS('refresh()'); //refresh() 方法是目标窗口中全局的函数,用于刷新页面;
// 或者简单点,直接用 webview 的刷新方法;
// listWebview.reload(true);
}
}
});
扩展阅读
wap2app概述(入门必读)
sitemap.json文档
app.js文档
wap2app应用强化
wap2app常见问题
0 个评论
要回复文章请先登录或注册