window


简介:

窗口对象。窗口对象是实现多窗口机制的基本单元。app维护了一个窗口堆栈,每个窗口以唯一的窗口名字来区别。窗口名字是rd.window.openWindow来赋值的。然而有一个窗口是比较特殊的,即加载起始的component是由application.xml中配置的,无法进行窗口名的赋值,因此对加载起始页的窗口统一命名为'root',window的方法都是在当前component下的操作。popover是窗口上的浮动窗口,通过openPopover打开,跟窗口对象一样。

方法:

回调方法:

openWindow


打开窗口

rd.window.openWindow(windowName,type,data,animation,extra);
说明:

打开一个新窗口,如果窗口名字相同,返回名字相同的窗口。

参数:
  • windowName: ( String ) 必选 窗口名字
  • type: 必选 窗口类型,当值为rd.window.WEBVIEW_LOCAL_STRING时,data必须是utf-8编码。
    • rd.window.WEBVIEW_LOCAL_RELATIVE_PATH: 值为0,加载本地html
    • rd.window.WEBVIEW_LOCAL_STRING: 值为1,加载html字符串
    • rd.window.WEBVIEW_REMOTE_URL: 值为2,加载url
  • data: ( String ) 必选 加载的窗口数据
  • animation: (JSON)可选 ,打开、关闭窗口动画,Android只支持设置无动画(rd.window.ANIMATION_TYPE_NONE),其它动画无效。
    • type: ( 窗口转场动画 ) 可选 转场动画类型,type默认值为rd.window.ANIMATION_TYPE_PUSH
    • direction: ( 窗口动画方向 ) 可选 动画方向,打开窗口默认为rd.window.ANIMATION_SUBTYPE_FROM_RIGHT,关闭窗口默认为rd.window.ANIMATION_SUBTYPE_FROM_LEFT
    • time: ( Number ) 可选 动画时间,time默认值为300ms
    • curve: ( 窗口执行动画曲线 ) 可选 动画曲线,curve默认值为rd.window.ANIMATION_CURVE_EASEINEASEOUT
  • extra: ( Extra ) 可选 页面属性和传值
返回值:

示例:
rd.window.openWindow('secondWindow',rd.window.WEBVIEW_LOCAL_RELATIVE_PATH,'test.html',    {type:rd.window.ANIMATION_TYPE_FADE,direction:rd.window.ANIMATION_SUBTYPE_FROM_RIGHT,time:    2000,curve:rd.window.ANIMATION_CURVE_LINEAR});

backToWindow


返回指定名字的窗口

rd.window.backToWindow(windowName,animation);
说明:

如果窗口不存在,无响应。

参数:
  • windowName: ( String ) 必选 窗口名字
  • animation: (JSON)可选 ,打开、关闭窗口动画,Android只支持设置无动画(rd.window.ANIMATION_TYPE_NONE),其它动画无效。
    • type: ( 窗口转场动画 ) 可选 转场动画类型,type默认值为rd.window.ANIMATION_TYPE_PUSH
    • direction: ( 窗口动画方向 ) 可选 动画方向,打开窗口默认为rd.window.ANIMATION_SUBTYPE_FROM_RIGHT,关闭窗口默认为rd.window.ANIMATION_SUBTYPE_FROM_LEFT
    • time: ( Number ) 可选 动画时间,time默认值为300ms
    • curve: ( 窗口执行动画曲线 ) 可选 动画曲线,curve默认值为rd.window.ANIMATION_CURVE_EASEINEASEOUT
返回值:

示例:
rd.window.backToWindow('secondWindow',    {type:rd.window.ANIMATION_TYPE_FADE,direction:rd.window.ANIMATION_SUBTYPE_FROM_LEFT,time:2000,curve:rd.window.ANIMATION_CURVE_LINEAR});

closeWindow


关闭指定名字的窗口

rd.window.closeWindow(windowName,animation);
说明:

如果窗口不存在,无响应(iOS设备如果关闭的是popover,暂时不支持动画)。

参数:
  • windowName: ( String ) 必选 窗口名字
  • animation: (JSON)可选 ,打开、关闭窗口动画,Android只支持设置无动画(rd.window.ANIMATION_TYPE_NONE),其它动画无效。
    • type: ( 窗口转场动画 ) 可选 转场动画类型,type默认值为rd.window.ANIMATION_TYPE_PUSH
    • direction: ( 窗口动画方向 ) 可选 动画方向,打开窗口默认为rd.window.ANIMATION_SUBTYPE_FROM_RIGHT,关闭窗口默认为rd.window.ANIMATION_SUBTYPE_FROM_LEFT
    • time: ( Number ) 可选 动画时间,time默认值为300ms
    • curve: ( 窗口执行动画曲线 ) 可选 动画曲线,curve默认值为rd.window.ANIMATION_CURVE_EASEINEASEOUT
返回值:

示例:
rd.window.closeWindow('secondWindow',{type:rd.window.ANIMATION_TYPE_FADE,direction:rd.window.ANIMATION_SUBTYPE_FROM_LEFT,time:2000,curve:rd.window.ANIMATION_CURVE_LINEAR});

closeSelf


关闭当前窗口

rd.window.closeSelf(animation);
说明:

关闭popover,暂时不支持动画

参数:
  • animation: (JSON)可选 ,打开、关闭窗口动画,Android只支持设置无动画(rd.window.ANIMATION_TYPE_NONE),其它动画无效。
    • type: ( 窗口转场动画 ) 可选 转场动画类型,type默认值为rd.window.ANIMATION_TYPE_PUSH
    • direction: ( 窗口动画方向 ) 可选 动画方向,打开窗口默认为rd.window.ANIMATION_SUBTYPE_FROM_RIGHT,关闭窗口默认为rd.window.ANIMATION_SUBTYPE_FROM_LEFT
    • time: ( Number ) 可选 动画时间,time默认值为300ms
    • curve: ( 窗口执行动画曲线 ) 可选 动画曲线,curve默认值为rd.window.ANIMATION_CURVE_EASEINEASEOUT
返回值:

示例:
rd.window.closeSelf({type:rd.window.ANIMATION_TYPE_FADE,direction:rd.window.ANIMATION_SUBTYPE_FROM_LEFT,time:2000,curve:rd.window.ANIMATION_CURVE_LINEAR});

evaluateScript


在指定component、window、popover执行javascript

rd.window.evaluateScript(componentName,windowName,popoverName,evaluateString);
说明:

如果4个参数 component(传""代表当前)->window(传""代表当前)->popover(传""代表在window执行)->script,如果
component名不为空,window名必填,否则不做任何处理

如果3个参数 当前component->window(传""代表当前)->popover(传""代表在window执行)->script

如果2个参数 当前component->当前window->popover(传""代表在window执行)->script

如果1个参数 当前component->当前window->script

如果componentName、windowName、popoverName没有找到,方法不做任何处理

参数:
  • componentName: ( String ) 可选 component名字
  • windowName: ( String ) 可选 window名字
  • popoverName: ( String ) 可选 popover名字
  • evaluateString: ( String ) 必选 执行的脚本
返回值:

示例:
rd.window.evaluateScript('','','alert(123);');

setPopoverVisible


设置popover是否隐藏

rd.window.setPopoverVisible(visible,popovername);
说明:

设置指定popover是否隐藏。

参数:
  • visible: ( Boolean ) 必选 false代表隐藏,true代表显示
  • popoverName: ( String ) 必选 popover名字
返回值:

示例:
rd.window.setPopoverVisible(false,'pop');

bringPopoverToFront


把指定popover置于最前面(不同的popover之间的操作)

rd.window.bringPopoverToFront(popoverName);
说明:

在当前窗口操作。

参数:
  • popoverName: ( String ) 必选 popover名字
返回值:

示例:
rd.window.bringPopoverToFront('pop');

sendPopoverToBack


把指定popover置于最后面

rd.window.sendPopoverToBack(popoverName);
说明:

在当前窗口操作。

参数:
  • popoverName: (String) 必选 popover名字
返回值:

示例:
rd.window.sendPopoverToBack('pop');

bringPopoverBelow


把指定popover置于指定popover下面

rd.window.bringPopoverBelow(firstPopoverName,secondPopoverName);
说明:

在当前窗口操作,把firstPopoverName置于secondPopoverName下面。

参数:
  • firstPopoverName: ( String ) 必选 popover名字
  • secondPopoverName: ( String ) 必选 popover名字
返回值:

示例:
rd.window.bringPopoverBelow('pop1','pop2');

bringPopoverAbove


把指定popover置于指定popover上面

rd.window.bringPopoverAbove(firstPopoverName,secondPopoverName);
说明:

在当前窗口操作,把firstPopoverName置于secondPopoverName上面。

参数:
  • firstPopoverName: ( String ) 必选 popover名字
  • secondPopoverName: ( String ) 必选 popover名字
返回值:

示例:
rd.window.bringPopoverAbove('pop1','pop2');

openPopover


打开popover

rd.window.openPopover(popoverName,type,data,rect,Extra);
说明:

打开一个新popover,如果popover名字相同,把指定popover置于最前面。

参数:
  • popoverName: ( String ) 必选 popover名字
  • type:(JSON) 必选 窗口类型
    • rd.window.WEBVIEW_LOCAL_RELATIVE_PATH: 值为0,加载本地html
    • rd.window.WEBVIEW_LOCAL_STRING: 值为1,加载html字符串
    • rd.window.WEBVIEW_REMOTE_URL: 值为2,加载url
  • data: ( String ) 必选 加载的窗口数据
  • rect:(JSON) 必选 frame,如果width为0,延伸到屏幕右边,如果height为0,延伸到屏幕下面
    • x: ( Number ) 必选 x轴开始坐标 仅支持整型
    • y: ( Number ) 必选 y轴开始坐标 仅支持整型
    • width: ( Number ) 必选 如果width为0,延伸到屏幕右边 仅支持整型
    • height: ( Number ) 必选 如果height为0,延伸到屏幕下面 仅支持整型
  • extra: ( Extra ) 可选 页面属性和传值
    返回值:

示例:
rd.window.openPopover('pop',rd.window.WEBVIEW_LOCAL_RELATIVE_PATH,'test.html',{x:0,y:64,width:0,height:0});

closePopover


关闭popover

rd.window.closePopover(popoverName);
说明:

在当前窗口关闭指定popover,如果popover名字没找到,无响应。

参数:
  • popoverName: ( String ) 必选 popover名字
返回值:

示例:
rd.window.closePopover('pop');

setPopoverRect


设置当前popover的frame

rd.window.setPopoverRect(rect);
说明:

参数:
  • rect: (JSON) 必选 frame,如果width为0,延伸到屏幕右边,如果height为0,延伸到屏幕下面
    • x: ( Number ) 必选 x轴开始坐标 仅支持整型
    • y: ( Number ) 必选 y轴开始坐标 仅支持整型
    • width: ( Number ) 必选 如果width为0,延伸到屏幕右边 仅支持整型
    • height: ( Number ) 必选 如果height为0,延伸到屏幕下面 仅支持整型
返回值:

示例:
rd.window.setPopoverRect({x:0,y:64,width:0,height:0});

lockRotate


锁定屏幕方向

rd.window.lockRotate(rotate);
说明:

参数:
  • rotate: ( Boolean ) 必选 false代表旋转,true代表锁定
返回值:

示例:
rd.window.lockRotate(true);

setAttr


设置窗口属性

rd.window.setAttr(attribute);
说明:

参数:
  • attribute: (JSON) 必选 窗口属性
    • bounces: ( Boolean ) 可选 webview滑动到边缘是否弹动,不支持Android设备
    • bgColor: ( String ) 可选 背景颜色,如果字段为空,颜色为白色,颜色支持6位RGB(例如#FFFFFF)或者8位RGBA(例如#7FFFFFFF,前两位是透明度),Android设备支持
    • vScrollBarEnabled: ( Boolean ) 可选 是否显示水平滚动条,不支持Android设备暂时
    • hScrollBarEnabled: ( Boolean ) 可选 是否显示垂直滚动条 ,不支持Android设备暂时
    • keyboard: ( Boolean ) 可选 键盘弹出后,输入框是否会自动定位,暂时不支持Android设备
    • dragDismiss: ( Boolean ) 可选 是否支持滑动消失键盘,暂时不支持Android设备
    • slideBack: ( Boolean ) 可选 是否支持滑动返回,设置window全局,ture表示支持,false表示不支持,暂时不支持 Android设备
    • hardwareEnabled: ( Boolean ) 可选 是否开启硬件加速,默认true,iOS不支持
返回值:

示例:
rd.window.setAttr({bounces:true,bgColor:'#FFFFFF',vScrollBarEnabled:true,hScrollBarEnabled:true,keyboard:false,dragDismiss:true,slideBack:true});

openComponent


打开指定component

rd.window.openComponent(componentName,defaultPage,animation);
说明:

component名字为component.xml中的所在目录字段。

参数:
  • componentName: ( String ) 必选 component名字
  • defaultPage: ( String ) 必选 如果传空(''),使用component.xml中配置的url。window的名字默认为root
  • animation: (JSON)可选 ,打开、关闭窗口动画,Android只支持设置无动画(rd.window.ANIMATION_TYPE_NONE),其它动画无效。
    • type: ( 窗口转场动画 ) 可选 转场动画类型,type默认值为rd.window.ANIMATION_TYPE_PUSH
    • direction: ( 窗口动画方向 ) 可选 动画方向,打开窗口默认为rd.window.ANIMATION_SUBTYPE_FROM_RIGHT,关闭窗口默认为rd.window.ANIMATION_SUBTYPE_FROM_LEFT
    • time: ( Number ) 可选 动画时间,time默认值为300ms
    • curve: ( 窗口执行动画曲线 ) 可选 动画曲线,curve默认值为rd.window.ANIMATION_CURVE_EASEINEASEOUT
  • extra: ( Extra ) 可选 页面属性和传值
    返回值:

示例:
rd.window.openComponent('cpt','defaultPage.html',{type:rd.window.ANIMATION_TYPE_FADE,direction:rd.window.ANIMATION_SUBTYPE_FROM_RIGHT,time:2000,curve:rd.window.ANIMATION_CURVE_LINEAR});

closeComponent


关闭指定component

rd.window.closeComponent(componentName,animation);
说明:

参数:
  • componentName: ( String ) 必选 如果传空(''),关闭当前component,否则,关闭指定名称的component
  • animation: (JSON)可选 ,打开、关闭窗口动画,Android只支持设置无动画(rd.window.ANIMATION_TYPE_NONE),其它动画无效。
    • type: ( 窗口转场动画 ) 可选 转场动画类型,type默认值为rd.window.ANIMATION_TYPE_PUSH
    • direction: ( 窗口动画方向 ) 可选 动画方向,打开窗口默认为rd.window.ANIMATION_SUBTYPE_FROM_RIGHT,关闭窗口默认为rd.window.ANIMATION_SUBTYPE_FROM_LEFT
    • time: ( Number ) 可选 动画时间,time默认值为300ms
    • curve: ( 窗口执行动画曲线 ) 可选 动画曲线,curve默认值为rd.window.ANIMATION_CURVE_EASEINEASEOUT
返回值:

示例:
rd.window.closeComponent('',{type:rd.window.ANIMATION_TYPE_FADE,direction:rd.window.ANIMATION_SUBTYPE_FROM_LEFT,time:2000,curve:rd.window.ANIMATION_CURVE_LINEAR});

addHeaderRefreshing


设置下拉刷新

rd.window.addHeaderRefreshing(headerRefreshingCallback(),HeaderRefreshSetting());
说明:

作用于窗口头部

参数:
  • successCallback: 必选 成功回调函数
  • settings: 可选,不设置为默认值
    • statusLabel: ( JSON对象 ) 可选 刷新状态文字
      • hidden: ( Boolean ) 可选 字体是否隐藏 默认false,表示不隐藏
      • font: ( Number ) 可选 字体大小 默认13
      • color: ( String ) 可选 字体颜色 默认#ffffff
      • pullText: ( String ) 可选 开始状态文字提示 默认下拉刷新
      • releaseText: ( String ) 可选 松开文字提示 默认松开即可刷新
      • refreshingText: ( String ) 可选 刷新中文字提示 默认加载中...
    • timeLabel: ( JSON对象 ) 可选 最后一次刷新时间
      • hidden: ( Boolean ) 可选 字体是否隐藏 默认false,表示不隐藏
      • font: ( Number ) 可选 字体大小 默认12
      • color: ( String ) 可选 字体颜色 #ffffff
    • image: ( String ) 可选 刷新状态显示箭头,默认显示一个黑色箭头指示
返回值:

示例:
var imagePath = "res://箭头.jpg";
var settings = {statusLabel:{hidden:false,font:14,color:'#00FF00',pullText:"下拉有惊喜",releaseText:"放手",refreshingText:"努力加载中。。。"},timeLabel:{hidden:false,font:12,color:'#0000FF'},image:imagePath};
rd.window.addHeaderRefreshing(headerRefreshingCallback(),settings);

headerRefreshingCallback


下拉刷新回调

 function headerRefreshingCallback () {

}
说明:

参数:

addFooterRefreshing


设置上拉刷新

rd.window.addFooterRefreshing(footerRefreshingCallback(),settings);
说明:

作用于窗口底部

参数:
  • footerRefreshingCallback: 必选 成功回调函数
  • settings: ( FooterRefreshSetting ) (JSON)可选,不设置为默认值
    • statusLabel: ( JSON对象 ) 可选 刷新状态文字
      • hidden: ( Boolean ) 可选 字体是否隐藏 默认false
      • font: ( Number ) 可选 字体大小 默认13
      • color: ( String ) 可选 字体颜色 默认#ffffff
      • pullText: ( String ) 可选 开始状态文字提示 默认上拉刷新
      • releaseText: ( String ) 可选 松开文字提示 默认松开即可刷新
      • refreshingText: ( String ) 可选 刷新中文字提示 默认加载中...
  • image: ( String ) 可选 刷新状态显示箭头,默认显示一个黑色箭头指示
返回值:

示例:
var imagePath = "res://箭头.jpg";
var settings = {label:{hidden:true,font:14,color:'#0000FF',pullText:"上拉看看",releaseText:"松手吧",refreshingText:"努力加载中。。。"},image:imagePath};
rd.window.addFooterRefreshing(footerRefreshingCallback(),settings);

footerRefreshingCallback


上拉刷新回调

function footerRefreshingCallback () {

}
说明:

参数:

endHeaderRefresh


结束下拉刷新

rd.window.endHeaderRefresh();
说明:

参数:

返回值:

示例:
rd.window.endHeaderRefresh();

endFooterRefresh


结束上拉刷新

rd.window.endFooterRefresh();
说明:

参数:

返回值:

示例:
rd.window.endFooterRefresh();

removeHeaderRefreshing


移除下拉刷新

rd.window.removeHeaderRefreshing();
说明:

参数:

返回值:

示例:
rd.window.removeHeaderRefreshing();

removeFooterRefreshing


移除上拉刷新

rd.window.removeFooterRefreshing();
说明:

参数:

返回值:

示例:
rd.window.removeFooterRefreshing();

statusBarStyle


设置状态栏文字颜色

rd.window.statusBarStyle(style);
说明:

设置当前窗口状态栏文字颜色(安卓系统状态栏文字无变化)。

参数:
  • style: ( Number ) 可选,默认为黑色,0 表示黑色。1 表示白色
返回值:

示例:
rd.window.statusBarStyle(1);
平台支持:
  • iOS设备(支持)

alert


带一个按钮的对话框

rd.window.alert(setting, tipsCallback())
说明:

参数:
  • setting: (JSON) 必选 设置内容
    • title: ( String ) 可选 对话框标题 无默认值
    • msg: ( String ) 可选 对话框内容 无默认值
    • buttons: ( String[] ) 可选 按钮标题 默认["确认"]
  • tipsCallback: ( tipsCallback ) 必选 响应回调
返回值:

示例:
function tipsCallback(tips,error){}
var  setting={title : '单按钮alert',msg : '只能显示一个按钮',buttons : ['按钮']}
rd.window.alert(setting, tipsCallback());

tipsCallback


弹出框回调

function tipsCallback (tips,error) {

}
说明:

参数:
  • tips: (JSON) 输入文字
    • buttonIndex: ( Number ) 必选 选中按钮index
    • text: ( String ) 必选 输入文字 只支持 prompt
  • error: ( String ) 错误信息

confirm


带两个或三个按钮的confirm对话框

rd.window.confirm(setting, tipsCallback())
说明:

参数:
  • setting: (JSON) 必选 设置内容
    • title: ( String ) 可选 对话框标题 无默认值
    • msg: ( String ) 对话框内容 无默认值
    • buttons: ( String[] ) 可选 按钮标题 若小于两个按钮,会补齐两个按钮;若大于三个按钮,则使用前三个按钮 默认["取消","确定"].
  • tipsCallback: 必选 响应回调
返回值:

示例代码
function tipsCallback(tips,error){}
var setting={title : '多按钮confirm',msg : '多按钮confirm',buttons : ['确认','放弃','取消']}
rd.window.confirm(setting, tipsCallback);

tipsCallback


弹出框回调

function tipsCallback (tips,error) {

}
说明:

参数:
  • tips: (JSON) 输入文字
    • buttonIndex: ( Number ) 必选 选中按钮index
    • text: ( String ) 必选 输入文字 只支持 prompt
  • error: ( String ) 错误信息

prompt


带两个或三个按钮和输入框的对话框

rd.window.prompt(setting, tipsCallback())
说明:

参数:
  • setting: (JSON) 必选 设置内容
    • title: ( String ) 可选 对话框标题 无默认值
    • msg: ( String ) 对话框内容 无默认值
    • text: ( String ) 可选 输入框里面的默认内容 默认无
    • type: ( String ) 可选 输入类型,不同输入类型弹出键盘类型不同,取值范围(text、password、number、email、url) 默认text
    • buttons: ( String[] ) 可选 按钮标题 若小于两个按钮,会补齐两个按钮;若大于三个按钮,则使用前三个按钮 默认值:["取消","确定"]
  • tipsCallback: 必选 响应回调
返回值:

示例代码
function tipsCallback(tips,error){}
var setting = {title : '这是一个prompt对话框',msg : '现在弹出了一个prompt对话框',text : '这是默认文字',type : 'text',buttons : ['确认','放弃','取消']}
rd.window.prompt(setting, tipsCallback());

tipsCallback


弹出框回调

function tipsCallback (tips,error) {

}
说明:

参数:
  • tips: (JSON) 输入文字
    • buttonIndex: ( Number ) 必选 选中按钮index
    • text: ( String ) 必选 输入文字 只支持 prompt
  • error: ( String ) 错误信息

setSlideLayout


设置抽屉.通过此方法设置抽屉.可单独配制左,右抽屉,也可以同时配制两个抽屉.

rd.window.setSlideLayout(slideLayoutParams);
说明:

当type参数为'left'时,表示设置左抽屉,当type参数为'right'时,表示设置右抽屉,当type参数为'all'时,表示同时设置左右抽屉.

参数:
  • slideLayoutParams:(JSON) 必选.用于配制抽屉
    • type : (String) 可选, 默认值:'all' . 侧滑类型('left':左抽屉、'right':右抽屉、'all':左右抽屉).
    • leftEdge : (Number) 可选, 默认值: 50 右侧滑时,侧滑window停留时露出的宽度.
    • rightEdge : (Number) 可选, 默认值: 50左侧滑时, 侧滑window停留时露出的宽度.
    • leftPane :(JSON) 可选 无默认值. 左抽屉描述.
      • name : (String) 必选 抽屉名字.
      • url : (String) 必选 页面地址.本地路径.
    • rightPane :(JSON) 可选 无默认值. 右抽屉描述.
      • name : (String) 必选 抽屉名字.
      • url : (String) 必选 页面地址.本地路径.
        返回值:

示例:
var slideLayoutParams = {

                type: 'left',
                leftEdge:200,
                rightEdge:200,
                leftPane: {
                    name: 'leftDrawer',
                    url: 'leftDrawer.html'
                }
            }

            rd.window.setSlideLayout(slideLayoutParams);

 var params = {
            type: 'right',
            leftEdge:200,
            rightEdge:200,
            rightPane: {
                name: 'rightDrawer',
                url: 'rightDrawer.html'
            }
        }

        rd.window.setSlideLayout(params);

addIgnoreArea


添加忽略抽屉手势窗口区域

addIgnoreArea(IgnoreParams,windowName)
说明:

该方法只用于安卓设备,iOS设备不需要执行此方法.

参数:
  • IgnoreParams: (JSON) 必选 窗口区域信息
    • x : (Number) 必选 区域坐标x值.
    • y : (Number) 必选 区域坐标x值.
    • width : (Number) 必选 区域宽度.
    • height : (Number) 必选 区域高度.
  • windownName: (String) 可选 window名称,设置某个window窗口忽略抽屉
返回值:

示例:
var IgnoreParams = {
            x:0,
            y:0,
            width:500,
            height:500
        };


rd.window.addIgnoreArea(IgnoreParams);


//如果需要在同一个页面添加其他忽略抽屉手势窗口区域,可在后边设置windowname
//rd.window.addIgnoreArea(params,'其他windowName');
平台支持:
  • Android(支持)

openSlidePane


开启左或者右抽屉.

rd.window.openSlidePane(SlideParams);
说明:

通过参数配制,来实现开启左右抽屉.通过左右手势滑动也能实现相同效果.

参数:
  • SlideParams: (JSON) 必选 JSON对象,用于描述开启哪个抽屉.
    • type : (String) 必选 值为'left',或者'right'.设定对应的值,开启对应的抽屉,如果抽屉不存在,没有任何操作.
返回值:

示例:
 var SlideParams = {
            type : 'right'
        }
        rd.window.openSlidePane(SlideParams);

closeSlidePane


关闭抽屉.

rd.window.closeSlidePane();
说明:

当某个抽屉处于左或右侧滑状态时,将其收起.

参数:

返回值:

示例:
rd.window.closeSlidePane();

getWidth


获取当前窗口的宽度.

var width = rd.window.getWidth();
说明:

获取当前窗口的宽度.

参数:

返回值:
  • width: ( Number ) 窗口宽度
示例:
var width = rd.window.getWidth();

getHeight


获取当前窗口的高度.

var height = rd.window.getHeight();
说明:

获取当前窗口的高度.

参数:

返回值:
  • height: ( Number ) 窗口宽度
示例:
var height = rd.window.getHeight();

getParams


获取当前窗口的页面参数.

var params = rd.window.getParams();
说明:

获取当前窗口的页面参数.

参数:

返回值:
  • params: ( JSON对象 ) 页面参数
示例:
var params = rd.window.getParams();

Extra


JSON对象

Extra 
{
    property Boolean bounces;
    property String bgColor;
    property Boolean vScrollBarEnabled;
    property Boolean hScrollBarEnabled;
    property Boolean keyboard;
    property Boolean dragDismiss;
    property Boolean slideBack;
    property JSON对象 pageParam;
    property Boolean hardwareEnabled;
} 
说明:

页面属性和传值。

属性:
  • bounces: ( Boolean ) 可选 webview滑动到边缘是否弹动,默认true,Android暂时不支持
  • bgColor: ( String ) 可选 背景颜色,如果字段为空,颜色为白色,颜色支持6位RGB(例如#FFFFFF)或者8位RGBA(例如#7FFFFFFF,前两位是透明度)
  • vScrollBarEnabled: ( Boolean ) 可选 是否显示水平滚动条,默认true,Android暂时不支持
  • hScrollBarEnabled: ( Boolean ) 可选 是否显示垂直滚动条,默认true,Android暂时不支持
  • keyboard: ( Boolean ) 可选 键盘弹出后,输入框是否会自动定位,默认true,Android暂时不支持
  • dragDismiss: ( Boolean ) 可选 是否支持滑动消失键盘,默认false,Android暂时不支持
  • slideBack: ( Boolean ) 可选 是否支持滑动返回,设置window全局,默认true,Android暂时不支持
  • pageParam: ( JSON对象 ) 可选 页面传值用,新页面中可在rd.window.getParams获取
  • hardwareEnabled: ( Boolean ) 可选 是否开启硬件加速,默认true,iOS不支持

窗口转场动画(Number):

  • rd.window.ANIMATION_TYPE_NONE: 值为-1,无动画

  • rd.window.ANIMATION_TYPE_FADE:值为10, 淡入淡出

  • rd.window.ANIMATION_TYPE_PUSH: 值为11,推入

  • rd.window.ANIMATION_TYPE_REVEAL: 值为12,显露

  • rd.window.ANIMATION_TYPE_MOVE_IN: 值为13,切入

  • rd.window.ANIMATION_TYPE_CUBE: 值为14,立方体翻转

  • rd.window.ANIMATION_TYPE_PAGE_CURL: 值为15,上翻页

  • rd.window.ANIMATION_TYPE_PAGE_UNCURL: 值为16,下翻页

  • rd.window.ANIMATION_TYPE_SUCK_EFFECT: 值为17,收缩

  • rd.window.ANIMATION_TYPE_RIPPLE_EFFECT:值为18, 水滴

  • rd.window.ANIMATION_TYPE_FLIP: 值为19,翻转

  • rd.window.ANIMATION_TYPE_ROTATE: 值为20,旋转

窗口动画方向(Number):

  • rd.window.ANIMATION_SUBTYPE_FROM_LEFT: 值为40,从左往右

  • rd.window.ANIMATION_SUBTYPE_FROM_RIGHT: 值为41,从右往左

  • rd.window.ANIMATION_SUBTYPE_FROM_TOP: 值为42,从上往下

  • rd.window.ANIMATION_SUBTYPE_FROM_BOTTOM: 值为43,,从下往上

窗口执行动画曲线(Number):

  • rd.window.ANIMATION_CURVE_LINEAR: 值为50,线性

  • rd.window.ANIMATION_CURVE_EASEIN: 值为51,从慢到快

  • rd.window.ANIMATION_CURVE_EASEOUT: 值为52,从快到慢

  • rd.window.ANIMATION_CURVE_EASEINEASEOUT: 值为53,从慢到快到慢