Links

初始化

通常情况下,View.js 将在页面被浏览器装载后,自动执行初始化动作。
初始化动作包括:
  1. 1.
    执行初始化监听器
    监听器通过API:View.beforeInit(callback: Function) 添加。
  2. 2.
    识别并标识操作系统类型
    <html> 结点上使用 data-view-os 属性自动标识识别到的操作系统。如:data-view-os = "ios"
  3. 3.
    确定视图容器
    如果没有元素声明为视图容器,则认定 document.body 为视图容器
  4. 4.
    扫描文档,创建视图实例
  5. 5.
    确定默认视图 如果没有视图显示声明为默认视图,将使用视图容器下,DOM 顺序上的第一个视图作为默认视图
  6. 6.
    使能属性:data-view-rel
  7. 7.
    使能属性:data-view-whr
  8. 8.
    执行就绪监听器
    监听器通过API:View.ready(callback: Function) 添加。
  9. 9.
    呈现地址栏中指定的视图
    如果视图是可以直接访问的,则将触发该视图的readyenter等事件。
上述动作,默认将在 documentDOMContentLoaded 事件被触发时自动执行。开发者可以借助下面的 API 自主决定初始化时机:
view.js
/**
* @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);
例如:
init.js
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 的初始化。例如:
view.html
init.js
<body data-view-container data-view-auto-init="false">
...
</body>
/**
* 向后端请求关键数据
*/
$.post("/someuri", function(data){
//...
/**
* 在必要条件准备完毕后,初始化 View.js
*/
View.init();
//...
});