View.layout

视图布局API

getLayoutWidth()

获取视图可布局空间的宽度,单位:像素。 宽度等于视图容器的宽度,减去视图容器的左右内边距。 视图的内容展现不应该超过该宽度。

签名:

View.layout.getLayoutWidth(): number

可用版本:1.6.2+

入参:

无。

返回:

视图可布局空间的宽度,单位:像素。

getLayoutHeight()

获取视图可布局空间的高度,单位:像素。 宽度等于视图容器的高度,减去视图容器的上下内边距。 视图的内容展现不应该超过该高度。

签名:

View.layout.getLayoutHeight(): number

可用版本:1.6.2+

入参:

无。

返回:

获取视图可布局空间的高度,单位:像素。

getBrowserWidth()

获取浏览器宽度,单位:像素。

签名:

View.layout.getBrowserWidth(): number

可用版本:1.6.2+

入参:

无。

返回:

浏览器宽度,单位:像素。

getBrowserHeight()

获取浏览器高度,单位:像素。

签名:

View.layout.getBrowserHeight(): number

可用版本:1.6.2+

入参:

无。

返回:

浏览器高度,单位:像素。

isLayoutPortrait()

判断布局空间是否为 potrait 模式:宽度小于等于高度。

签名:

View.layout.isLayoutPortrait(): boolean

可用版本:1.6.2+

入参:

无。

返回:

布局空间是否为 potrait 模式。

isLayoutLandscape()

判断布局空间是否为 landscape 模式:宽度大于高度。

签名:

View.layout.isLayoutLandscape(): boolean

可用版本:1.6.2+

入参:

无。

返回:

布局空间是否为 landscape 模式。

isBrowserPortrait()

判断浏览器是否为 potrait 模式:宽度小于等于高度。

签名:

View.layout.isBrowserPortrait(): boolean

可用版本:1.6.2+

入参:

无。

返回:

浏览器是否为 portrait 模式。

isBrowserLandscape()

判断浏览器是否为 landscape 模式:宽度大于高度。

签名:

View.layout.isBrowserLandscape(): boolean

可用版本:1.6.2+

入参:

无。

返回:

浏览器是否为 landscape 模式。

getLayoutWidthHeightRatio()

获取布局空间的宽高比。

签名:

View.layout.getLayoutWidthHeightRatio(): number

可用版本:1.6.2+

入参:

无。

返回:

布局空间的宽高比。

getBrowserWidthHeightRatio()

获取浏览器的宽高比。

签名:

View.layout.getBrowserWidthHeightRatio(): number

可用版本:1.6.2+

入参:

无。

返回:

浏览器的宽高比。

getExpectedWidthHeightRatio()

获取设置的、在PC上横屏浏览应用时,页面布局空间的宽高比。 PC 上横屏浏览时,View.js 默认将页面以 320 * 568 分辨率(iPhone5 的分辨率)渲染。此时,视图容器的高度为浏览器窗口的高度,宽度为 高度 / 568 * 320 ,并且水平居中。 开发者可以使用 data-view-whr 属性 和 View.layout.setExpectedWidthHeightRatio() 设置为其它分辨率。

签名:

View.layout.getExpectedWidthHeightRatio(): number

可用版本:1.6.2+

入参:

无。

返回:

PC上横屏浏览应用时,页面布局空间的宽高比。

setExpectedWidthHeightRatio()

设置在PC上横屏浏览应用时,页面布局空间的宽高比。 PC 上横屏浏览时,View.js 默认将页面以 320 * 568 分辨率(iPhone5 的分辨率)渲染。此时,视图容器的高度为浏览器窗口的高度,宽度为 高度 / 568 * 320 ,并且水平居中。 开发者可以使用 data-view-whr 属性 和 View.layout.setExpectedWidthHeightRatio() 设置为其它分辨率。

签名:

View.layout.setExpectedWidthHeightRatio(): View.layout

可用版本:1.6.2+

入参:

无。

返回:

View.layout - 以供开发者链式调用API。

init()

设置布局配置并初始化。

签名:

View.layout.init(ops: ViewLayoutInitOptions): View.layout

可用版本:1.6.2+

入参:

  • ops - 配置选项。可选。

返回:

View.layout - 以供开发者链式调用API。

doLayout()

根据当前的浏览模式和状态执行一次布局动作。

签名:

View.layout.doLayout(async?: boolean): View.layout

可用版本:1.6.2+

入参:

  • async - 是否异步执行。可选,默认为:true

返回:

View.layout - 以供开发者链式调用API。

addLayoutChangeListener()

添加 “布局空间发生变化” 监听器。

签名:

View.layout.addLayoutChangeListner(listener: ViewLayoutChangeLisener): View.layout

可用版本:1.6.2+

入参:

  • listener - 监听器。

返回:

View.layout - 以供开发者链式调用API。

removeLayoutChangeListener()

移除 “布局空间发生变化” 监听器。

签名:

View.layout.removeLayoutChangeListner(listener: ViewLayoutChangeLisener): View.layout

可用版本:1.6.2+

入参:

  • listener - 监听器。

返回:

View.layout - 以供开发者链式调用API。