通常情况下,View.js 将在页面被浏览器装载后,自动执行初始化动作。
初始化动作包括:
执行初始化监听器
监听器通过API:View.beforeInit(callback: Function)
添加。
识别并标识操作系统类型
在 <html>
结点上使用 data-view-os
属性自动标识识别到的操作系统。如:data-view-os = "ios"
。
确定视图容器
如果没有元素声明为视图容器,则认定 document.body
为视图容器
确定默认视图
如果没有视图显示声明为默认视图,将使用视图容器下,DOM 顺序上的第一个视图作为默认视图
执行就绪监听器
监听器通过API:View.ready(callback: Function)
添加。
呈现地址栏中指定的视图
如果视图是可以直接访问的,则将触发该视图的ready
、enter
等事件。
上述动作,默认将在 document
的 DOMContentLoaded
事件被触发时自动执行。开发者可以借助下面的 API 自主决定初始化时机:
/**
* @typdef {Function} Initializer
* @param {Function} init - 视图的初始化方法句柄。
* 开发者需要在时机合适的时候主动调用该方法,使得 View.js 可以完成初始化。
* 如果init方法没有被调用,则 View.js 不会被初始化。
*/
/**
* 设置初始化器
* @param {Initializer} 初始化器
* @param {String} [execTime=domready] 提供的初始化器的执行时机
*
* 支持的初始化器执行时机包括:
* 1) domready DOM就绪后自动执行(设置的callback)
* 2) rightnow 立即执行(设置的callback)
*/
View.setInitializer({Initializer} callback, {String} execTime);
例如:
View.setInitializer(function(init){
/**
* 向后端请求关键数据
*/
$.post("/someuri", function(data){
//...
/**
* 在必要条件准备完毕后,初始化 View.js
*/
init();
//...
});
}, "rightnow");/* 'rightnow' 向 View.js 标明:立即执行提供的初始化动作 */
从 1.7.0
开始,开发者可以通过在视图容器上声明 data-view-auto-init
属性,并赋值为 "false"
,即可避免自动执行初始化动作。同时,在恰当时机通过执行API:View.init()
手动出发 View.js 的初始化。例如:
<body data-view-container data-view-auto-init="false">
...
</body>
/**
* 向后端请求关键数据
*/
$.post("/someuri", function(data){
//...
/**
* 在必要条件准备完毕后,初始化 View.js
*/
View.init();
//...
});