View.js博文目录

一、常用API

1、View

static currentState

static context 公用数据存取上下文，用于跨视图存取数据。

static checkIfBrowserHistorySupportsPushPopAction()

static getViewContainerDomElement()

static find() 从 DOM 树中获取匹配给定选择器的 DOM 元素。

static findAll() 从 DOM 树中获取匹配给定选择器的多个 DOM 元素。

static ofId() 获取视图实例。

static back() 返回至上一个视图。

static beforeInit() 添加 View.js 初始化前要执行的处理器。

static ready() 添加 View.js 就绪后要执行的处理器。

static init() 初始化 View.js 。

static on()

添加宏观事件监听器。预置的宏观事件包括： 1. beforechange - 活动视图即将切换（同步触发） 2. change - 活动视图正在切换（同步触发） 3. afterchange - 活动视图切换完成（异步触发）

开发者也可以使用该方法监听自定义事件。

static off()  移除宏观事件监听器。

static fire() 发起宏观事件。

namespace

logger

config

context

getId()

getContext() 获取视图内置的数据存取上下文，等同于 context 属性。

clearContext()

getDomElement()

getName()

getGroupName()

find() 在视图的 DOM 骨架元素内部查找匹配给定选择器的 DOM 元素。

findAll() 在视图的 DOM 骨架元素内部查找匹配给定选择器的 DOM 元素集合。

setLayoutAction()

getLayoutAction()

hasParameter() 判断视图参数中是否含有给定键名的参数。

getParameter() 获取视图参数。

setIfAutoSaveParamsToContext()

getIfAutoSaveParamsToContext()

setDataFetchAction()

getDataFetchAction()

fetchData()

seekParameter()

isReady()

isActive()

isDefault()

isDirectlyAccessible()

setAsDirectlyAccessible()

setTitle()

getTitle()

setFallbackViewId()

getFallbackView()

on()

off()

fire()

getLatestEventData()

addTimer()

startTimer()

startAllTimers()

stopTimer()

stopAllTimers()

2、ViewContext，视图上下文，用于存取数据，避免变量污染。

has() 判断上下文中是否含有给定键名的数据。

set() 向上下文中添加或更新数据。如果给定键名的数据尚不存在，则添加数据，否则覆盖键名对应的既有数据。

get() 从上下文中获取给定键名对应的数据。如果键名在上下文中并不存在，则返回 undefined。

remove() 从上下文中移除给定键名对应的数据，并返回被移除的数据。如果数据尚不存在，则返回 undefined。

clear() 清空上下文中，移除上下文中的所有数据。

listKeys() 列举上下文中的所有键名。

size() 获取上下文中存放的数据个数。

3、ViewConfiguration，视图配置 - 单个配置项。

getName()

getValue()

setValue()

getApplication()

apply()

reflectToDom()

4、ViewConfigurationSet，视图配置 - 配置项集合。

has()

get()

applyAll()

listAll()

 二、属性

data-view-id 标识视图的ID。

data-view-name 标识视图的名称。

data-view-namespace 标识视图隶属的命名空间名称。

data-view-title 设置视图标题。视图标题将在视图变为活动状态时自动更新为浏览器标题。

data-view-default 标识特定视图为默认视图。

data-view-directly-accessible 标识视图是否可以直接访问。

data-view-group 标识视图隶属的群组名称。

data-view-fallback 声明视图不能直接访问时，将要回退显示的视图的ID。

data-view-fallback-namespace 声明视图不能直接访问时，将要回退显示的视图所属的命名空间。

data-view-container 标识特定 DOM 元素为视图容器。所有开发者创建的视图 DOM，都应该是视图容器的子元素。

data-view-auto-init 设置 View.js 是否在文档加载完毕后自动执行初始化动作。

data-view-rel 声明点击后的跳转目标。

data-view-rel-namespace 声明跳转目标视图所隶属的命名空间名称。

data-view-rel-disabled 设置 data-view-rel 属性是否被禁用。

data-view-whr 设置视图容器的渲染宽高比（width height ratio）。当浏览环境为 PC landscape（宽度大于高度）模式时工作。