Trust
Trust
  • 发布:2018-01-23 17:14
  • 更新:2018-01-23 17:14
  • 阅读:3502

【文档】wap2app之app.js

分类:wap2app

该文章意在汇总整理 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 关注 分享

要回复文章请先登录注册