view


视图对象是操作当前页面引擎接口的对外调用对象,每个页面只有一个view对象(即使多次调用获取的仍是同一个对象),通过该对象来完成对该页面的大多数设置操作。

创建一个view对象很简单,只需通过app的currentView方法即可。

    var view = app.currentView();

索引


方法

  • addFooterRefresh :给当前页面添加上拉加载
  • addHeaderRefresh :给当前页面添加下拉刷新
  • addSlideIgnore :添加当前页面忽略抽屉手势窗口区域(该方法只用于安卓,主要用于与JS滑动事件冲突时使用)
  • back :返回上一层或返回指定名字的窗口
  • close :关闭当前页面
  • closePopover :关闭指定Popover对象
  • createPopover :创建Popover对象
  • disableBounces :设置页面不可弹动(Android暂时不支持)
  • disableDragDismiss :设置页面不支持滑动消失键盘(Android暂时不支持)
  • disableHScrollBar :设置页面不显示垂直滚动条(Android暂时不支持)
  • disableKeyboard :设置键盘弹出后,输入框不自动定位(Android暂时不支持)
  • disableVScrollBar :设置页面不显示水平滚动条(Android暂时不支持)
  • enableBounces :设置页面可弹动(Android暂时不支持)
  • enableDragDismiss :设置页面支持滑动消失键盘(Android暂时不支持)
  • enableHScrollBar :设置页面显示垂直滚动条(Android暂时不支持)
  • enableKeyboard :设置键盘弹出后,输入框自动定位(Android暂时不支持)
  • enableVScrollBar :设置页面显示水平滚动条(Android暂时不支持)
  • getHeight :获取当前窗口的高度
  • getWidth :获取当前窗口的宽度
  • setAnimationCurve :设置页面关闭时的动画曲线(Android暂时不支持)
  • setAnimationDirection :设置页面关闭时的动画方向(Android暂时不支持)
  • setAnimationDuration :设置页面关闭时的动画持续时间(Android暂时不支持)
  • setAnimationType :设置页面关闭时的动画类型(Android暂时不支持)
  • setBgcolor :设置页面背景色,颜色支持6位RGB(例如#FFFFFF)或者8位RGBA(例如#7FFFFFFF,前两位是透明度)
  • setFrameSize :设置当前页面的位置、长宽
  • removeFooterRefresh :删除上拉加载
  • removeHeaderRefresh :删除下拉刷新

对象


方法


addFooterRefresh

  • addFooterRefresh(options) ⇒ footerRefresher

       给当前页面添加上拉加载
    
    • options :配置JSON对象
      • type:JSON
      • 默认值:无
      • keys
        • contentdown:开始状态文字提示
          • type:String
          • 默认值:'上拉显示更多'
        • contentover:松开文字提示
          • type:String
          • 默认值:'释放立即刷新'
        • contentrefresh:刷新中文字提示
          • type:String
          • 默认值:'正在加载...'
        • callback:加载成功回调函数
          • type:Function
          • 默认值:无
  • 示例:
        var view = app.currentView();

        EX - 1:
        var footerRefresher = view.addFooterRefresh({
            contentdown: '上拉可以刷新',
            contentover: '释放立即刷新',
            contentrefresh: '正在刷新...',
            callback: function() {
                footerRefresher.completeRefresh();
            }
        });

        EX - 2:
        var footerRefresher = view.addFooterRefresh({
            contentdown: '上拉可以刷新',
            contentover: '释放立即刷新'
            callback: function() {
                footerRefresher.completeRefresh();
            }
        });

        EX - 3:
        var footerRefresher = view.addFooterRefresh({
            contentdown: '上拉可以刷新'
            callback: function() {
                footerRefresher.completeRefresh();
            }
        });

        EX - 4:
        var footerRefresher = view.addFooterRefresh({
            callback: function() {
                footerRefresher.completeRefresh();
            }
        });

addHeaderRefresh

  • addHeaderRefresh(options) ⇒ headerRefresher

       给当前页面添加下拉刷新 (参见:headerRefresher)
    
    • options :配置JSON对象
      • contentdown:开始状态文字提示
        • type:String
        • 默认值:'下拉可以刷新'
      • contentover:松开文字提示
        • type:String
        • 默认值:'释放立即刷新'
      • contentrefresh:刷新中文字提示
        • type:String
        • 默认值:'正在刷新...'
      • callback:刷新成功回调函数
        • type:Function
        • 默认值:无
  • 示例:
       var view = app.currentView();
    
       EX - 1:
       var headerRefresher = view.addHeaderRefresh({
           contentdown: '下拉可以刷新',
           contentover: '释放立即刷新',
           contentrefresh: '正在刷新...',
           callback: function() {
               headerRefresher.completeRefresh();
           }
       });
    
       EX - 2:
       var headerRefresher = view.addHeaderRefresh({
           contentdown: '下拉可以刷新',
           contentover: '释放立即刷新'
           callback: function() {
               headerRefresher.completeRefresh();
           }
       });
    
       EX - 3:
       var headerRefresher = view.addHeaderRefresh({
           contentdown: '下拉可以刷新'
           callback: function() {
               headerRefresher.completeRefresh();
           }
       });
    
       EX - 4:
       var headerRefresher = view.addHeaderRefresh({
           callback: function() {
               headerRefresher.completeRefresh();
           }
       }); 
    

addSlideIgnore

  • addSlideIgnore([x], [y], [width], [height]) ⇒ void

       添加当前页面忽略抽屉手势窗口区域(该方法只用于安卓,主要用于与JS滑动事件冲突时使用)
    
    • x:区域坐标x值(以左上角为基础)
      • type:Number
      • 默认值:0
    • y:区域坐标y值(以左上角为基础)
      • type:Number
      • 默认值:0
    • width:区域宽度
      • type:Number
      • 默认值:当前窗口的宽度
    • height:区域高度
      • type:Number
      • 默认值:当前窗口的高度
  • 示例:
       var view = app.currentView();
       view.addSlideIgnore(0,0,500,500); 
    

back

  • back([windowname]) ⇒ void

       关闭当前窗口或返回指定名字的窗口,当windowname不传时,默认关闭当前窗口
    
    • windowname:指定窗口的名字
      • type:String
      • 默认值:无
  • 示例:
       var view = app.currentView();
    
       EX-1:
       view.back(); //返回上一层
    
       EX-2:
       view.back('windowname'); //返回名字为windowname的窗口
    

close

  • close() ⇒ void

       关闭当前页面
    
  • 示例:
       var view = app.currentView();
       view.close();
    

closePopover

  • closePopover(popovername) ⇒ void

       关闭指定Popover对象
    
    • popovername:指定popover对象的name值
      • type:String
      • 默认值:无
  • 示例:
       var view = app.currentView();
       view.closePopover('popName');
    

createPopover

  • createPopover([x], [y], [width], [height]) ⇒ popover

       新建一个popover对象
    
    • x:区域坐标x值(以左上角为基础)
      • type:Number
      • 默认值:0
    • y:区域坐标y值(以左上角为基础)
      • type:Number
      • 默认值:0
    • width:区域宽度,如果width为0,延伸到屏幕右边
      • type:Number
      • 默认值:当前窗口的宽度
    • height:区域高度,如果height为0,延伸到屏幕下面
      • type:Number
      • 默认值:当前窗口的高度
  • 示例:
       var view = app.currentView();
       var pop = view.createPopover(0,60,0,0);
    

disableBounces

  • disableBounces() ⇒ void

       设置页面不可弹动(Android暂时不支持)
    
  • 示例:
       var view = app.currentView();
       view.disableBounces();
    

disableDragDismiss

  • disableDragDismiss() ⇒ void

       设置页面不支持滑动消失键盘(Android暂时不支持)
    
  • 示例:
       var view = app.currentView();
       view.disableDragDismiss();
    

disableHScrollBar

  • disableHScrollBar() ⇒ void

       设置页面不显示垂直滚动条(Android暂时不支持)
    
  • 示例:
       var view = app.currentView();
       view.disableHScrollBar();
    

disableKeyboard

  • disableKeyboard() ⇒ void

       设置键盘弹出后,输入框不自动定位(Android暂时不支持)
    
  • 示例:
       var view = app.currentView();
       view.disableKeyboard();
    

disableVScrollBar

  • disableVScrollBar() ⇒ void

       设置页面不显示水平滚动条(Android暂时不支持)
    
  • 示例:
       var view = app.currentView();
       view.disableVScrollBar();
    

enableBounces

  • enableBounces() ⇒ void

       设置页面可弹动(Android暂时不支持)
    
  • 示例:
       var view = app.currentView();
       view.enableBounces();
    

enableDragDismiss

  • enableDragDismiss() ⇒ void

       设置页面支持滑动消失键盘(Android暂时不支持)
    
  • 示例:
       var view = app.currentView();
       view.enableDragDismiss();
    

enableHScrollBar

  • enableHScrollBar() ⇒ void

       设置页面显示垂直滚动条(Android暂时不支持)
    
  • 示例:
       var view = app.currentView();
       view.enableHScrollBar();
    

enableKeyboard

  • enableKeyboard() ⇒ void

       设置键盘弹出后,输入框自动定位(Android暂时不支持)
    
  • 示例:
       var view = app.currentView();
       view.enableKeyboard();
    

enableVScrollBar

  • enableVScrollBar() ⇒ void

       设置页面显示水平滚动条(Android暂时不支持)
    
  • 示例:
       var view = app.currentView();
       view.enableVScrollBar();
    

getHeight

  • getHeight() ⇒ void

       获取当前窗口的高度
    
  • 示例:
       var view = app.currentView();
       view.getHeight(); //获取当前窗口的宽度
    

getWidth

  • getWidth() ⇒ void

       获取当前窗口的宽度
    
  • 示例:
       var view = app.currentView();
       view.getWidth(); //获取当前窗口的宽度
    

setAnimationCurve

  • setAnimationCurve([curve]) ⇒ void

       设置页面关闭时的动画曲线(Android暂时不支持)
    
    • curve:动画曲线类型
      • type:Number
      • 默认值:53
      • 取值范围
        • 50:线性
        • 51:从慢到快
        • 52:从快到慢
        • 53:从慢到快到慢
  • 示例:
       var view = app.currentView();
       view.setAnimationCurve(50); //设置动画曲线为线性
    

setAnimationDirection

  • setAnimationDirection([direction]) ⇒ void

       设置页面关闭时的动画方向(Android暂时不支持)
    
    • direction:动画方向
      • type:Number
      • 默认值:41
      • 取值范围
        • 40:从左往右
        • 41:从右往左
        • 42:从上往下
        • 43:从下往上
  • 示例:
       var view = app.currentView();
    
       EX-1:
       view.setAnimationDirection(40); //设置为从左往右
    
       EX-2:
       view.setAnimationDirection(42); //设置为从上往下
    

setAnimationDuration

  • setAnimationDuration([duration]) ⇒ void

       设置页面关闭时的动画持续时间(Android暂时不支持)
    
    • duration:动画时间
      • type:Number
      • 默认值:300(单位ms)
  • 示例:
       var view = app.currentView();
       view.setAnimationDuration(200); //设置为动画时间为200ms
    

setAnimationType

  • setAnimationType([type]) ⇒ void

       设置页面关闭时的动画类型,仅iOS支持,Android只支持设置无动画(-1),其它动画无效。
    
    • type:窗口动画类型,仅iOS支持,Android只支持设置无动画(-1),其它动画无效。
      • type:number
      • 默认值:11
      • 取值范围
        • 10:淡入淡出
        • 11:推入
        • 12:显露
        • 13:切入
        • 14:立方体翻转
        • 15:上翻页
        • 16:下翻页
        • 17:收缩
        • 18:水滴
        • 19:翻转
        • 20:旋转
        • 21:照相机打开
        • 22:照相机关闭
  • 示例:
       var view = app.currentView();
    
       EX-1:
       view.setAnimationType(10); //设置为淡入淡出
    
       EX-2:
       view.setAnimationType(12); //设置为显露
    

setBgcolor

  • setBgcolor(bgcolor) ⇒ void

       设置页面背景色,如果字段为空,颜色为白色,颜色支持6位RGB(例如#FFFFFF)或者8位RGBA(例如#7FFFFFFF,前两位是透明度),该背景颜色与css样式中BODY的背景颜色不同,该颜色处于BODY背景色的更下层,属于是窗口层级的
    
    • bgcolor:背景色
      • type:String
      • 默认值:无
  • 示例:
       var view = app.currentView();
       view.setBgcolor('#000');
    

setFrameSize

  • setFrameSize([x], [y], [width], [height]) ⇒ void

       设置当前页面的位置、长宽
    
    • x:区域坐标x值(以左上角为基础)
      • type:Number
      • 默认值:0
    • y:区域坐标y值(以左上角为基础)
      • type:Number
      • 默认值:0
    • width:区域宽度
      • type:Number
      • 默认值:当前窗口的宽度
    • height:区域高度
      • type:Number
      • 默认值:当前窗口的高度
  • 示例:
       var view = app.currentView();
       view.setFrameSize(0,0,300,400); //设置当前页面的位置、长宽
    

removeFooterRefresh

  • removeFooterRefresh() ⇒ void

       删除上拉加载
    
  • 示例:
       var view = app.currentView();
       view.removeFooterRefresh(); //删除上拉加载
    

removeHeaderRefresh

  • removeHeaderRefresh() ⇒ void

       删除下拉刷新
    
  • 示例:
       var view = app.currentView();
       view.removeHeaderRefresh(); //删除下拉刷新
    

对象


headerRefresher

    var view = app.currentView();
    var headerRefresher = view.addHeaderRefresh({
            contentdown: '下拉可以刷新',
            contentover: '释放立即刷新',
            contentrefresh: '正在刷新...',
            callback:function(){
                headerRefresher.completeRefresh();
            }
          }); 
  • completeRefresh() ⇒ void

       结束下拉刷新
    
  • 示例:
       headerRefresher.completeRefresh();
    
  • setContentFontSize([size]) ⇒ void

       设置刷新区域字体的大小
    
    • size:字体的大小
      • type:Number
      • 默认值:13
  • 示例:
       headerRefresher.setContentFontSize(13);
    
  • setContentFontColor(color) ⇒ void

       设置刷新区域字体的颜色
    
    • color:颜色
      • type:String
      • 默认值:无
  • 示例:
       headerRefresher.setContentFontColor('#FFFFFF');
    
  • setTimeFontSize([size]) ⇒ void

       设置刷新时间区域字体的大小
    
    • size:字体的大小
      • type:Number
      • 默认值:12
  • 示例:
       headerRefresher.setTimeFontSize('13');
    
  • setTimeFontColor(color) ⇒ void

       设置刷新时间区域字体的颜色
    
    • color:颜色
      • type:String
      • 默认值:无
  • 示例:
       headerRefresher.setTimeFontColor('#FFFFFF');
    
  • setImagePath(path) ⇒ void

       设置刷新箭头图标的地址
    
    • path:地址
      • type:String
      • 默认值:无
  • 示例:
       headerRefresher.setImagePath("res://箭头.jpg");
    

footerRefresher

    var view = app.currentView();
    var footerRefresher = view.addFooterRefresh({
            contentdown: '上拉可以刷新',
            contentover: '释放立即刷新',
            contentrefresh: '正在刷新...',
            callback:function(){
                footerRefresher.completeRefresh();
            }
          }); 
  • completeRefresh() ⇒ void

       结束上拉加载
    
  • 示例:
       footerRefresher.completeRefresh();
    
  • setContentFontSize([size]) ⇒ void

       设置刷新区域字体的大小
    
    • size:字体的大小
      • type:Number
      • 默认值:13
  • 示例:
       footerRefresher.setContentFontSize('13');
    
  • setContentFontColor(color) ⇒ void

       设置刷新区域字体的颜色
    
    • color:颜色
      • type:String
      • 默认值:无
  • 示例:
       footerRefresher.setContentFontColor('#FFFFFF');
    
  • setImagePath(path) ⇒ void

       设置刷新箭头图标的地址
    
    • path:地址
      • type:String
      • 默认值:无
  • 示例:
       footerRefresher.setImagePath("res://箭头.jpg");