窗口模块Window

appcan是多窗口的,该模块封装了关于窗口的基础操作

appcan.window.open(name,data,aniId,type,dataType,width,height,animDuration,extraInfo) //打开一个新的窗口
    name:新窗口的的名称,如果窗口存在直接打开,如果不存在先创建然后打开
    data:新窗口填充的数据
    dataType:新窗口填充的数据类型
           0: url
            1: html 数据//必如传入的是一个<div></div>
            2: html 和 url 混合数据
    aniId:动画类型Id
            0: 无动画
            1: 从左向右推入
            2: 从右向左推入
            3: 从上向下推入
            4: 从下向上推入
            5: 淡入淡出
            6: 左翻页
            7: 右翻页
            8: 水波纹
            9: 由左向右切入
          10: 由右向左切入
          11: 由上先下切入
          12: 由下向上切入
          13: 由左向右切出 
          14: 由右向左切出
          15: 由上向下切出
          16: 由下向上切出
    type:窗口类型
            0: 普通窗口
            1: OAuth 窗口
            2: 加密页面窗口
            4: 强制刷新
          16: view不透明
          32: 隐藏的window
          64: 等待popOver加载完毕后显示
        128: 支持手势
        256: 标记open的window上一个window不隐藏
        512: 标记open的浮动窗口用于打开webapp。此浮动窗口将不进行默认字体的设置,缩放比例的设置等,WebApp的排版适配交由系统处理。注意:此flag仅用于open浮动窗口。
    width:要打开的窗口宽度,请传0
    height:要打开的窗口高度,请传0
    animDuration:动画执行时间
    extraInfo:扩展参数,设置值时,animDuration参数必传

例子:

appcan.window.open({
                 name:name,
                 dataType:0,
                 aniId:2,
                 data:name + ".html",
                 extraInfo:{
                     opaque:true,
                     bgColor:bg
                 }
            });

参数还可以以对象的形式传参:

 {     
    name:"",    
    data:"",
    dataType:"",
    aniId:"",
    type:"",
    width:"",
    height:"",
    animDuration:""
}

例如:

 //打开一个新demo窗口,并加载appcan.cn页面
appcan.window.open({
    name:'demo',
    dataType:0,
    data:'http://appcan.cn'
});
//另外一种使用方式
var win = appcan.require('window');
win.open({
    name:'demo',
    dataType:0,
    data:'http://appcan.cn'
});
appcan.window.close(aniId,animDuration) //关闭当前窗口
    aniId:动画类型Id
         0:无动画
        1: 从左向右推入
        2: 从右向左推入
        3: 从上向下推入
        4: 从下向上推入
        5: 淡入淡出
        6: 左翻页
        7: 右翻页
        8: 水波纹
        9: 由左向右切入
      10: 由右向左切入
      11: 由上先下切入
      12: 由下向上切入
      13: 由左向右切出
      14: 由右向左切出
      15: 由上向下切出
      16: 由下向上切出
    animDuration:动画持续时间

参数还可以以对象的形式传参:

 {
    aniId:"",
    animDuration:""
}

例如:

 //关闭当前窗口
appcan.window.close({
    aniId:17,
    animDuration:1000
});
//另外一种使用方式
var win = appcan.require('window');
win.close({
    aniId:17,
    animDuration:1000
});
appcan.window.evaluateScript(name,scriptContent,type) //在指定的窗口脚本执行
    name:要执行脚本的窗口名称
    scriptContent:要执行的脚本
    type:窗口类型

参数还可以以对象的形式传参:

{
    name:'',
    scriptContent:'',
    type:''
}

例子:

 //在demo窗口执行脚本
appcan.window.evaluateScript({
        name:'demo',
        scriptContent:'alert("hello world")'
    });
    //另一种使用方式
    var win = appcan.require('window');
    win.evaluateScript({
        name:'demo',
        scriptContent:'alert("hello world")'
    });
appcan.window.evaluatePopoverScript(name,popName,scriptContent) //在指定的弹出窗内执行相应的脚本
    name:要执行脚本的窗口名称
    popName:要执行的弹出窗口的名称
    scriptContent:要执行的脚本内容

参数还可以以对象的形式传参:

{
    name:'',
    popName:'',
    scriptContent:''
}

例子:

 //在demo窗口的弹出窗口执行脚本
appcan.window.evaluatePopoverScript({
        name:'demo',
        popName:'demoPop',
        scriptContent:'alert("hello world")'
    });
    //另一种使用方式
    var win = appcan.require('window');
    win.evaluatePopoverScript({
        name:'demo',
        popName:'demoPop',
        scriptContent:'alert("hello world")'
    });
appcan.window.setBounce(bounceType,startPullCall,downEndCall,upEndCall,color,imgSettings) //设置上下弹动效果
    bounceType:弹动的类型,如果为多个请用数组
       0: 是向下拖动
       1: 是向上拖动
    startPullCall:开始滑动时触发回调
    downEndCall:上拉或者下拉超过边界执行回调
    upEndCall:上拉或者下拉,超过边界之后,恢复最初状态执行回调
    color:如果超过了该边界显示的背景颜色
    imgSettings:如果超过了该边界,并且想要设置显示的内容包括图片文字则设置该参数

关于imgSettings的设定的实例:

{
    "imagePath":"res://reload.png",
    "textColor":"#530606",
    "pullToReloadText":"拖动刷新",
    "releaseToReloadText":"释放刷新",
    "loadingText":"加载中,请稍等"
}

参数还可以以对象的形式传参:

 {
     bounceType:'',
        startPullCall:function(){
            //do somethings
        },
        downEndCall:function(){
            //do somethings
        },
        upEndCall:function(){
            //do somethings
        },
        color:'',
        imgSettings:{}
}

例如:

  //给页面添加一个简单的弹动效果
    appcan.window.setBounce({
        bounceType:'1',
        color:'#F00',
        upEndCall:function(type){

        }
    });
    //另一种使用方式
    var win = appcan.require('window');
    win.setBounce({
        bounceType:'1',
        color:'#F00',
        upEndCall:function(type){

        }
    });
appcan.window.enableBounce() //开启页面弹动效果

如果调用该方法,则该webView具有弹动效果 例如:

//开启页面弹动效果
appcan.window.enableBounce()
//另一种使用方式
var win = appcan.require('window');
win.enableBounce()
appcan.window.disableBounce() //禁用页面弹动效果

如果调用该方法,则该webView不具有弹动效果 例如:

//禁用页面弹动效果
appcan.window.disableBounce();//禁用页面弹动效果
//另一种使用方式
var win = appcan.require('window');
win.disableBounce();
appcan.window.setBounceType(type,color,flag,callback) //设置页面弹动类型

前提是开启webView的弹动设置,如果没有开启调用了该方法则会默认开启页面弹动效果

    type:页面的弹动类型
        0: 无任何效果
        1: 颜色弹动效果
        2: 设置图片弹动
    color:设置弹动结果的背景颜色
    flag:是否显示内容,1:显示内容,0:不显示内容
    callback(status,type):当设置成功后,如果滑动超过了弹动的边界,则会触发该回调,status: 当type=0时,值0为向下拉,1为超越边界,2为向上返回到最初状态;当type=1时,0为向上拉,1为超越边界,2为向下返回到最初状态。 type跟传入的参数type一致

参数还可以以对象的形式传参:

{
    type:'',
    callback:function(status,type){
        //do somethings
    },
    flag:'',
    color:''
}

例如:

//设置上边弹动
appcan.window.setBounceType({
    type:1,
    flag:1,
    color:'#F00',
    callback:function(status,type){
        if(stats == 1){
            //超过边界了
        }
    }
});
//另外一种使用方式
var win = appcan.require('window');
win.setBounceType({
    type:1,
    flag:1,
    color:'#F00',
    callback:function(status,type){
        if(stats == 1){
            //超过边界了
        }
    }
});
appcan.window.setBounceParams(position,data) //设置对应弹动显示的内容
    position:页面的弹动位置
          0: 顶端
           1: 底部
    data:超过页面边界显示的内容

关于data设置的实例:

{
    "imagePath":"res://reload.png",
    "textColor":"#530606",
    "pullToReloadText":"拖动刷新",
    "releaseToReloadText":"释放刷新",
    "loadingText":"加载中,请稍等"
}

参数还可以以对象的形式传参:

{
    position:'',
    data:{}
}

例如:

//设置参数
appcan.window.setBounceParams({
    position:1,
    data:{
        "imagePath":"res://reload.png",
        "textColor":"#530606",
        "pullToReloadText":"拖动刷新",
        "releaseToReloadText":"释放刷新",
        "loadingText":"加载中,请稍等"
    }
});
//另外一种使用方式
var win = appcan.require('window');
win.setBounceParams({
    position:1,
    data:{
        "imagePath":"res://reload.png",
        "textColor":"#530606",
        "pullToReloadText":"拖动刷新",
        "releaseToReloadText":"释放刷新",
        "loadingText":"加载中,请稍等"
    }
});
appcan.window.resetBounceView(position) //恢复默认弹动
position:页面的弹动位置
    0: 顶端
    1: 底部

参数还可以以对象的形式传参:

{
    position:''
}

例如:

//重置顶部效果
appcan.window.resetBounceView(0)
//另外一种使用方式
var win = appcan.require('window');
win.resetBounceView(0)
appcan.window.openToast(msg,duration,position,type) //打开一个toast弹出窗口
    msg:toast要显示的内容
    duration:toast显示的时间
    position:toast显示在屏幕中的位置
         1: left_top 左上
         2: top 上中
         3: right_top 右上
         4: left 左中
         5: middle 中间
         6: right 右中
         7: bottom_left 下左
         8: bottom 下中
         9: right_bottom 右下
    type:toast的类型
         0: 没有进度条
         1: 有进度条

参数还可以以对象的形式传参:

{
    msg:'',
    duration:'',
    position:'',
    type:''
}

例如:

//打开一个没有弹出框的toast
appcan.window.openToast({
    msg:'toast',
    duration:1000,
    position:9,
    type:0
});
//另外一种使用方式
var win = appcan.require('window');
win.openToast({
    msg:'toast',
    duration:1000,
    position:9,
    type:0
});
appcan.window.closeToast() //关闭现在显示的toast

例如:

//关闭当前页面的toast
appcan.window.closeToast();
//另外一种使用方式
var win = appcan.requrie('window');
win.closeToast();
appcan.window.moveAnim(left,top,callback,duration) //以动画的形式,移动弹出窗口
    left:距离左边的位置
    top:距离上边的位置
    callback:动画移动完成后的回调函数
    duration:动画持续的时间

参数还可以以对象的形式传参:

{
    left:'',
    top:'',
    callback:function(){
        //do somethings
    },
    duration:''
}

例如:

//把弹出窗口移动到指定的位置
appcan.window.moveAnim({
    left:10,
    top:10,
    callback:functin(){
        //动画完成
    }
});
//另外一种使用方式
var win = appcan.require('window');
win.moveAnim({
    left:10,
    top:10,
    callback:functin(){
        //动画完成
    }
});
appcan.window.openPopover(name,dataType,url,data,left,top,width,height,fontSize,type,bottomMargin,extraInfo) //打开一个浮动窗口/弹出框

如果不存在则会先创建然后再打开,如果存在则直接打开

    name:要打开弹出窗的名称
    dataType:新窗口填充的数据类型
          0: url
          1: html 数据//必如传入的是一个<div></div>
          2: html 和 url 混合数据
    url:弹出框要加载的页面的地址
    data:弹出框要加载的数据内容
    left:弹出框距离左边的距离
    top:弹出框距离上边的距离
    width:弹出框的宽度
    height:弹出框的高度
    fontSize:页面基础的字体大小
    type:窗口类型
           0: 普通窗口
           1: OAuth 窗口
           2: 加密页面窗口
           4: 强制刷新
         16: view不透明
         32: 隐藏的window
         64: 等待popOver加载完毕后显示
       128: 支持手势
       256: 标记open的window上一个window不隐藏
       512: 标记open的浮动窗口用于打开webapp。此浮动窗口将不进行默认字体的设置,缩放比例的设置等,WebApp的排版适配交由系统处理。注意:此flag仅用于open浮动窗口。
    bottomMargin:浮动窗口相对父窗口底部的距离。为空或0时,默认为0。当值不等于0时,height参数无效
    extraInfo:扩展参数,设置值时,bottomMargin参数必传

例子:

appcan.window.openPopover({
                 name:'demo',
                 dataType:0,
                 url:name + ".html",
                 top:100,
                 left:100,
                 width:1400,
                 height:2100,
                 extraInfo:{
                     opaque:true,
                     bgColor:bg
                 }
            });

参数还可以以对象的形式传参:

{
    name:'',
    dataType:'',
    url:'',
    data:'',
    left:'',
    top:'',
    width:'',
    height:'',
    fontSize:'',
    type:''
    bottomMargin:''
    }

例如:

//弹出一个简单的demo窗口,并打开appcan.cn
appcan.window.openPopover({
    name:'demo',
    dataType:0,
    url:'http://appcan.cn',
    top:100,
    left:100,
    width:100,
    height:100,
});
//另外一种使用方式
var win = appcan.require('window');
win.openPopover({
    name:'demo',
    dataType:0,
    url:'http://appcan.cn',
    top:100,
    left:100,
    width:100,
    height:100,
});
appcan.window.closePopover(name) //关闭指定的弹出窗口
name:弹出窗口的名字

参数还可以以对象的形式传参:

{
    name:''
}

例如:

//关闭demo弹出窗口
appcan.window.closePopover('demo');
//另外一种使用方式
var win = appcan.require('win');
win.closePopover('demo');
appcan.window.resizePopover(name,left,top,width,height) //重置指定弹出窗口的大小、位置
    name:要重置的弹出窗口的名称
    left:要重置弹出窗口距离左边的距离
    top:要重置的弹出窗口距离上边的距离
    width:要重置的弹出窗口的宽度
    height:要重置弹出窗口的高度

参数还可以以对象的形式传参:

{
    name:'',
    left:'',
    top:'',
    width:'',
    height:''
}

例如:

//修改demo弹出框的位置
appcan.window.resizePopover({
    name:'demo',
    left:100,
    top:100,
    width:102,
    height:102
})
//另外一种使用方式
var win = appcan.require('window');
win.resizePopover({
    name:'demo',
    left:100,
    top:100,
    width:102,
    height:102
})
appcan.window.alert(title,content,buttons,callback) //弹出一个确认弹出窗口

如果只有一个按钮弹出是警告框,如果是一个以上的按钮弹出的是提示框

    title:弹出框的标题
    content:弹出框的内容
    buttons:弹出框的按钮列表最多是三个
    callback(err,data,dataType,optId):当点击了其中一个按钮后的回调,如果只有一个确定按钮则不执行回调函数 第一个参数是Error对象如果为空则表示没有错误,否则表示操作出错了,data表示返回的操作结果,dataType操作结果的数据类型,optId该操作id

参数还可以以对象的形式传参:

//{
    title:'',
    content:'',
    buttons:[],
    callback:function(err,data,dataType,optId){
        //do somethings
    }
}

例如:

//打开一个提示框 
appcan.window.alert({
    title:'提示',
    content:'小提示',
    buttons:'确定'
});
//另外一种使用方式
var win = appcan.require('window'); 
win.alert({
    title:'提示',
    content:'小提示',
    buttons:'确定'
});
appcan.window.confirm(title,content,buttons,callback) //弹出一个提示框
    title:弹出框的标题
    content:弹出框的内容
    buttons:弹出框的按钮列表最多是三个
    callback(err,data,dataType,optId):当点击了其中一个按钮后的回调, 第一个参数是Error对象如果为空则表示没有错误,否则表示操作出错了,data表示返回的操作结果,dataType操作结果的数据类型,optId该操作id

参数还可以以对象的形式传参:

{
    title:'',
    content:'',
    buttons:[],
    callback:function(err,data,dataType,optId){
        //do somethings
    }
}

例如:

//打开一个确认框 
appcan.window.confirm({
    title:'提示',
    content:'小提示',
    buttons:['确定','取消'],
    callback:function(err,data,dataType,optId){
        if(err){
            //如果出错了
            return;
        }
        //data 按照按钮的索引返回值
    }
});
//另外一种使用方式
var win = appcan.require('window'); 
win.confirm({
    title:'提示',
    content:'小提示',
    buttons:['确定','取消'],
    callback:function(err,data,dataType,optId){
        if(err){
            //如果出错了
            return;
        }
        //data 按照按钮的索引返回值
    }
});
appcan.window.prompt(title,content,defaultValue,buttons,callback) //弹出一个可以输入内容的提示框
    title:提示框的标题
    content:提示框中显示的内容
    defaultValue:(String类型) 必选 输入框默认文字
    buttons:提示框显示的按钮,多个按钮可以为数组形式
    callback(err,data,dataType,optId):当点击了其中一个按钮后的回调, 第一个参数是Error对象如果为空则表示没有错误,否则表示操作出错了,data表示返回的操作结果{index:'按钮的索引值',data:'输入框的值'},dataType操作结果的数据类型,optId该操作id

参数还可以以对象的形式传参:

{
   title:'',
    content:'',
    defaultValue:'',
    buttons:'',
    callback:function(){}
}
`
appcan.window.bringPopoverToFront(name) //把指定的弹出窗口设置为最上层
name:要设置的弹出层的名称

参数还可以以对象的形式传参:

{
    name:''
}

例如:

//把demo窗口显示到所有窗口最上面
appcan.window.bringPopoverToFront('demo');
//另外一种使用方式
var win = appcan.require('window'); 
win.bringPopoverToFront('demo');
appcan.window.popoverElement(id,url,left,top,name,extraInfo) //根据给定元素的样式弹出样式相似的弹出窗口
    id:指定元素的Id
    url:要加载到弹出窗口中的地址
    left:距离左边界的距离
    top:距离上边界的距离
    name:弹出窗口的名称,如果id没有指定的话用name,否则用id
    extraInfo:扩展参数,json格式如下: {"extraInfo":{"opaque":"true","bgColor":"#011","delayTime":"250"}}

参数还可以以对象的形式传参:

{
    id:'',
    url:'',
    left:'',
    top:'',
    name:''
}

例如:

//根据指定的元素打开弹出框,并打开appcan.cn
appcan.window.popoverElement({
    id:'container',
    url:'http://appcan.cn',
    top:'100',
    left:100
});
//另外一种使用方式
var win = appcan.require('window');
win.popoverElement({
    id:'container',
    url:'http://appcan.cn',
    top:'100',
    left:100
});
appcan.window.resizePopoverByEle(id,left,top,name) //设置指定的弹出窗口恢复到指定窗口的大小,并设置弹出窗的位置
    id:指定的元素,根据该元素设置弹出窗口的大小
    left:弹出窗口距离左边界的距离
    top:弹出窗口距离上边界的距离
    name:要设置的弹出窗口的名称,如果id没有传值的话使用这个值

参数还可以以对象的形式传参:

{
    id:'',
    left:'',
    top:'',
    name:''
}

例如:

//重置demo窗口,位置
appcan.window.popoverElement({
    id:'container',
    left:100,
    top:100
});
//另外一种使用方式
var win = appcan.require('window');
win.popoverElement({
    id:'container',
    left:100,
    top:100
});
appcan.window.openMultiPopover(popName,content,dataType,left,top,width,height,change,fontSize,flag,indexSelected,extraInfo) //打开多页面浮动窗口页面间可切换

打开多页面浮动窗口,页面之间可滑动切换,设置是否支持滑动参照setMultilPopoverFlippingEnbaled

    popName:打开新窗口的名称
    content:要传入的数据,一个json对象,或者json字符串,
    结构必须为'{"content":[{"inPageName":"p1","inUrl":"xxx1.html","inData":"", {"extraInfo":{"opaque":"true","bgColor":"#011"}}},{"inPageName":"p2","inUrl":"xxx2.html","inData":"", {"extraInfo":{"opaque":"true","bgColor":"#011"}}}]}' 其中:inPageName:所包含的单页面窗口的名字,inUrl:url类型数据,inData:窗口的内容的二进制数据,可为空,extraInfo:extraInfo参数,opaque:是否透明 true/false默认为false,bgColor:背景色,支持图片和颜色,格式为#fff、#ffffff、rgba(r,g,b,a)等,图片路径支持res://、wgt://等AppCan协议路径
    dataType:窗口载入的数据的类型
        0:url方式载入;
        1:html内容 方式载入;//必如传入的是一个<div></div>
        2:既有url方式,又有html内容方式
    left:距离左边界的距离
    top:距离上边界的距离
    width:窗口的宽
    height:窗口的高
    change(err,data):当浮动窗口的当前显示的值发生改变是触发的回调.
          err:如果出错这个就是一个错误对象,否则为空.
       data:{"multiPopName":"name","multiPopSelectedIndex":"index"}
    fontSize:字体的大小
    flag:窗口类型
         0: 普通窗口
         1: OAuth 窗口
         2: 加密页面窗口
         4: 强制刷新
         8: url用系统浏览器打开
       16: view不透明
       32: 隐藏的window
       64: 等待popOver加载完毕后显示
     128: 支持手势
     256: 标记open的window上一个window不隐藏
     512: 标记被open的浮动窗口用于打开webapp.此浮动窗口将不进行默认字体的设置,缩放比例的设置等,WebApp的排版适配交由系统处理。注意:此flag仅用于open浮动窗口。
    indexSelected:默认显示的索引项,默认显示第一项
    extraInfo:扩展参数,json格式如下: {"extraInfo":{"opaque":"true","bgColor":"#011","delayTime":"250"}}

例子: 实例代码,相似用法appcan.frame.open

var content = {
                content:[
                    {
                        inPageName:"p1",
                        inUrl:"pop1.html",
                        inData:"",
                        extraInfo:{
                            opaque:false,
                            bgColor:"#00000000"
                        }
                    },
                    {
                        inPageName:"p2",
                        inUrl:"pop2.html",
                        inData:"",
                        extraInfo:{
                            opaque:true,
                            bgColor:"#ccc"
                        }
                    }
                ]
            };

            appcan.window.openMultiPopover({
                popName:name,
                content:content,
                top:0,
                left:0,
                height:500,
                width:500,
                dataType:0,
                indexSelected:1,
                extraInfo:{
                    opaque:false,
                    bgColor:bg
                }
            });

参数还可以以对象的形式传参:

 {
    popName:'',
    content:'',
    dataType:'',
    left:'',
    top:'',
    width:'',
    height:'',
    change:'',
    fontSize:'',
    flag:'',
    indexSelected:''
}

例如:

 //打开一个四个窗口的弹出框
appcan.window.openMultiPopover({
    popName:'nav',
    content:{
        content:[{
            inPageName:'p1',
            inUrl:'http://www.appcan.cn',
            inData:''
        },{
            inPageName:'p2',
            inUrl:'http://www.appcan.cn',
            inData:''
        },{
            inPageName:'p3',
            inUrl:'http://www.appcan.cn',
            inData:''
        },{
            inPageName:'p4',
            inUrl:'http://www.appcan.cn',
            inData:''
        }]
    },
    height:500,
    dataType:0,
    indexSelected:2
});
//另外一种使用方式
var win = appcan.require('window');
win.openMultiPopover({
    popName:'nav',
    content:{
        content:[{
            inPageName:'p1',
            inUrl:'http://www.appcan.cn',
            inData:''
        },{
            inPageName:'p2',
            inUrl:'http://www.appcan.cn',
            inData:''
        },{
            inPageName:'p3',
            inUrl:'http://www.appcan.cn',
            inData:''
        },{
            inPageName:'p4',
            inUrl:'http://www.appcan.cn',
            inData:''
        }]
    },
    height:500,
    dataType:0,
    indexSelected:2
});
appcan.window.closeMultiPopover(popName) //关闭多页面浮动窗口
    popName:多页面窗口的名称

参数还可以以对象的形式传参:

{
    popName:''
}

例如:

 //关闭指定的多页面浮动窗口
appcan.window.closeMultiPopover('nav');
//另外一种使用方式
var win = appcan.require('window');
win.closeMultiPopover('nav');
appcan.window.selectMultiPopover(popName,index) //设置多页面浮动窗口跳转到的子页面窗口的索引
    popName:要设置的多页面浮动窗口的名称
    index:要设置的多页面浮动窗口页面的索引

参数还可以以对象的形式传参:

{
    popName:'',
    index:''
}

例如:

 //选择第三个页面
appcan.window.selectMultiPopover('nav',2);
//另外一种使用方式
var win = appcan.require('window');
win.selectMultiPopover('nav',2);
appcan.window.subscribe(channelId,callback) //订阅一个频道

如果有消息发给该频道,则会执行响应的回调;如果是用超链接打开的页面收不到消息。

channelId:订阅的的频道Id
callback(msg):当有消息发来的时候执行的对调,msg是传来的消息

参数还可以以对象的形式传参:

{
    channelId:'',
    callback:''
}

例如:

 //接收2通道的消息
appcan.window.subscribe('2',function(msg){});
//另外一种使用方式
var win = appcan.require('window');
win.subscribe('2',function(msg){});
appcan.window.publish(channelId,msg) //向指定通道发送消息
channelId:发送指定消息的通道
msg:要发送的消息内容

参数还可以以对象的形式传参:

{
    channelId:'',
    msg:''
}

例如:

 //向2通道发送消息
appcan.window.publish('2','hello')
//另外一种使用方式
var win = appcan.require('window');
win.publish('2','hello')
appcan.window.sendPopoverToBack(name) //把指定的浮动窗口设置到最下层
name:要设置的浮动窗口名称

参数还可以以对象的形式传参:

{
    name:''
}

例如:

 //把a窗口放到最下成
appcan.window.sendPopoverToBack('a')
//另外一种使用方式
var win = appcan.require('window');
win.sendPopoverToBack('a')
appcan.window.setWindowFrame(dx,dy,duration,callback) //移动当前Window相对屏幕的位置
dx: 相对屏幕左边的距离
dy: 相对屏幕上边的距离
duration: 动画执行的时间
callback: 当前窗口位置移动完成的回调方法

参数还可以以对象的形式传参:

{
    dx:'',
    dy:'',
    duration:'',
    callback:function(){}
}

例如:

 //把窗口向左移动100像素
appcan.window.setWindowFrame(100,0,300,function(){})
//另外一种使用方式
var win = appcan.require('window');
win.setWindowFrame(100,0,300,function(){})
appcan.window.stateChange(callback) //窗口前后台状态变化
callback(state)回调方法,
state:(Number)状态值 ,0:回到前台;1:压入后台
appcan.window.onResume //窗口回到前台时调用该方法(不推荐)
appcan.window.onPause //窗口回到后台时调用该方法(不推荐)
appcan.window.on('resume',callback) //窗口回到前台时执行回调函数
appcan.window.on('resume',callback)

窗口回到前台时执行回调函数

appcan.window.on('pause',callback) //窗口回到后台时执行回调函数
appcan.window.on('pause',callback)

窗口回到后台时执行回调函数

appcan.window.monitorKey(id,enable,callback) //捕获android实体键

参数:

id:要拦截的键值id,0-返回键,1-菜单键
enable:是否拦截,0-不拦截,1-拦截
callback(id):(Function)点击实体键时的回调函数
    id:按键的值,0:返回键;1:菜单键

JS SDK版本支持:

1.0.0+

例子:

appcan.window.monitorKey({
    id:"0",
    enable:"1",
    callback:function(id){
        alert("点击的按键:"id);    
    }
});
appcan.window.actionSheet(title,cancelText,buttons,callback) //弹出一个可选的菜单列表

参数:

title: 菜单列表的标题
cancelText: 取消按钮上显示文字内容
buttons:(Array)显示在菜单列表上的文字集合
callback(err,data):  菜单列表关闭的回调 
    err:Error对象,如果没错则为空
    data:选择的按钮的索引值

JS SDK版本支持:

1.0.0+

例子:

appcan.window.actionSheet("title","cancel",[1,2,3],function(err,data){
    alert(data)
});
或者
appcan.window.actionSheet({
    title:"title",
    cancelText:"cancel",
    buttons:[1,2,3],
    callback:function(err,data){
        if(!err)alert(data)
    }
});
appcan.window.setSlidingWindow(leftSliding,rightSliding,animationId,bg) //设置侧滑窗口

参数:

leftSliding: 左侧滑窗口,如:{width:240,url:”uexWindow_left.html”}
rightSliding: 右侧滑窗口,如:{width:240,url:”uexWindow_right.html”}
animationId: 打开窗口动画类型
bg:侧滑窗口背景图片

JS SDK版本支持:

1.0.0+

例子:

appcan.window.setSlidingWindow({
    leftSliding : {
        width : 240,
        url : "slidingWindow/uexWindow_left.html"
    },
    rightSliding : {
        width : 240,
        url : "slidingWindow/uexWindow_left1.html"
    },
    animationId : '1', //仿QQ侧滑
    bg : 'res://1_1.jpg' //仿QQ侧滑;注:res目录为js文件夹同级目录wgtRes
});
appcan.window.toggleSlidingWindow(mark,reload) //打开或关闭侧滑窗口

注:打开侧滑窗口前,需先调用setSlidingWindow设置打开的侧滑窗口信息

参数:

mark :必选, 左右侧窗口标识,0:左侧,1:右侧
reload :可选, 是否重新加载页面 ,1:重新加载

JS SDK版本支持:

1.0.0+

例子:

appcan.window.toggleSlidingWindow({
    mark:0,
    reload:1
})

appcan.window.toggleSlidingWindow({
    mark:1
})
appcan.window.setSlidingWindowEnabled(enable) //设置侧滑窗口是否可用

参数:

enable 侧滑窗口是否可用,0:不可用,1:可用

JS SDK版本支持:

1.0.0+

例子:

appcan.window.setSlidingWindowEnabled(1);
appcan.window.getSlidingWindowState(callback) //获取侧滑窗口显示情况

参数:

callback(data):回调函数
    data:返回的显示情况,0:左侧菜单显示;1:主界面显示;2:右侧菜单显示

JS SDK版本支持:

1.0.0+

例子:

appcan.window.getSlidingWindowState(function(data){
    alert(data);
});
appcan.window.getUrlQuery(callback) //获取加载页面时传入的参数

(注:目前只支持IOS)

参数:

callback(data):回调函数
    data:传入的参数数据内容

JS SDK版本支持:

1.0.0+

例子:

appcan.window.getUrlQuery(function(data){
    alert(data);
    //如id=123,则为id=123
});
appcan.window.setStatusBarTitleColor(type) //设置状态条上字体的颜色

(注:只支持IOS系统)

参数:

type:状态条上字体的颜色,0为白色(iOS7以上为透明底,iOS7以下为黑底), 1为黑色(iOS7以上为透明底,iOS7以下为白底)

JS SDK版本支持:

1.0.0+

例子:

appcan.window.setStatusBarTitleColor(1);
appcan.window.getState(callback) //获取窗口是否处于前台

参数:

callback(data):回调函数
data:返回的状态值,0:前台;1:后台;

JS SDK版本支持:

1.0.0+

例子:

appcan.window.getState(function(data){
    if(data == 0){
        alert("当前窗口处于前台")
    }else if(data ==1){
        alert("当前窗口处于后台");
    }
});
appcan.window.setWindowScrollbarVisible(enable) //设置内容超过一屏滚动的时候滚动条的显示和隐藏

参数:

enable: 滚动条的显示和隐藏,0:隐藏,1:显示

JS SDK版本支持:

1.0.0+

例子:

//滚动时不显示滚动条
appcan.window.setWindowScrollbarVisible(0);

//滚动时显示滚动条
appcan.window.setWindowScrollbarVisible(1)
appcan.window.hiddenBounceView(type) //隐藏弹动效果

参数:

type: 隐藏的位置,0:顶端,1:底部

JS SDK版本支持:

1.0.0+

例子:

//顶端隐藏弹动效果
appcan.window.hiddenBounceView(0);

//底部隐藏弹动效果
appcan.window.hiddenBounceView(1)
appcan.window.showBounceView(type,color,flag) //显示弹动效果

参数:

type: 弹动的位置,0:顶端弹动;1:底部弹动
color: 弹动显示部位的颜色值,内容不超过一屏时底部弹动内容不显示
flag: 是否显示内容,1:显示;0:不显示

JS SDK版本支持:

1.0.0+

例子:

appcan.window.showBounceView({
    type:0,
    color:'#fff000',
    flag:1
});
appcan.window.insertAbove(name) //将当前浮动窗口插入到指定浮动窗口之上

参数:

name: 指定的浮动窗口的名称

JS SDK版本支持:

1.0.0+

例子:

//主窗口打开两个浮动窗口
appcan.window.openPopover({ 
    name:"pop1",
    url:"popFrame1.html",
    top:200,
    left:0,
    height:200
});
appcan.window.openPopover({
    name:"pop2",
    url:"popFrame2.html",
    top:300,
    left:0,
    height:200
});

//此时按打开先后pop2在上面
//pop1内执行以下代码则pop1浮动窗口插入到pop2浮动窗口上面
appcan.window.insertAbove("pop2");
appcan.window.insertBelow(name) //将当前浮动窗口插入到指定浮动窗口之下

参数:

name: 指定的浮动窗口的名称

JS SDK版本支持:

1.0.0+

例子:

//主窗口打开两个浮动窗口
appcan.window.openPopover({ 
    name:"pop1",
    url:"popFrame1.html",
    top:200,
    left:0,
    height:200
});
appcan.window.openPopover({
    name:"pop2",
    url:"popFrame2.html",
    top:300,
    left:0,
    height:200
});

//此时按打开先后pop2在上面
//pop2内执行以下代码则pop2浮动窗口插入到pop1浮动窗口下面
appcan.window.insertBelow("pop1");
appcan.window.insertPopoverAbovePopover(nameA,nameB) //将指定浮动窗口插入到另一浮动窗口之上,只在主窗口中有效

参数:

nameA: 指定浮动窗口A的名称
nameB: 指定浮动窗口B的名称

JS SDK版本支持:

1.0.0+

例子:

//主窗口打开两个浮动窗口
appcan.window.openPopover({ 
    name:"pop1",
    url:"popFrame1.html",
    top:200,
    left:0,
    height:200
});
appcan.window.openPopover({
    name:"pop2",
    url:"popFrame2.html",
    top:300,
    left:0,
    height:200
});

//此时按打开先后pop2在上面
//pop1插入到pop2上面
appcan.window.insertPopoverAbovePopover("pop1","pop2");
或者
appcan.window.insertPopoverAbovePopover({
    nameA:"pop1",
    nameB:"pop2"
});
appcan.window.insertPopoverBelowPopover(nameA,nameB) //将指定浮动窗口插入到另一浮动窗口之下,只在主窗口中有效

参数:

nameA: 指定浮动窗口A的名称
nameB: 指定浮动窗口B的名称

JS SDK版本支持:

1.0.0+

例子:

//主窗口打开两个浮动窗口
appcan.window.openPopover({ 
    name:"pop1",
    url:"popFrame1.html",
    top:200,
    left:0,
    height:200
});
appcan.window.openPopover({
    name:"pop2",
    url:"popFrame2.html",
    top:300,
    left:0,
    height:200
});

//此时按打开先后pop2在上面
//pop1插入到pop2上面
appcan.window.insertPopoverBelowPopover("pop2","pop1");
或者
appcan.window.insertPopoverBelowPopover({
    nameA:"pop2",
    nameB:"pop1"
});
appcan.window.insertWindowAboveWindow(nameA,nameB) //将指定窗口A插入到另一窗口B之上

该接口仅对显示在屏幕上且不被隐藏的window起作用。(即open该window时,type传入的是256)

参数:

nameA: 指定窗口A的名称
nameB: 指定窗口B的名称

JS SDK版本支持:

1.0.0+

例子:

appcan.window.insertWindowAboveWindow("window1","window2");
或者
appcan.window.insertWindowAboveWindow({
    nameA:"window1",
    nameB:"window2"
});
appcan.window.insertWindowBelowWindow(nameA,nameB) //将指定窗口A插入到另一窗口B之下

该接口仅对显示在屏幕上且不被隐藏的window起作用。(即open该window时,type传入的是256)

参数:

nameA: 指定窗口A的名称
nameB: 指定窗口B的名称

JS SDK版本支持:

1.0.0+

例子:

//window1插入到window2下面
appcan.window.insertWindowBelowWindow("window1","window2");
//或者
appcan.window.insertWindowBelowWindow({
    nameA:"window1",
    nameB:"window2"
});
appcan.window.onPopoverLoadFinishInRootWnd(callback) //浮动窗口加载完成的监听方法

参数:

callback(name,url):监听的回调函数
    name:浮动窗口的名称
    url:浮动窗口的url;当浮动窗口加载的是本地网页时,url返回网页的绝对路径(file:// 开头)当浮动窗口加载的是网络上的网页时,url返回网址(http:// 开头)

JS SDK版本支持:

1.0.0+

例子:

appcan.window.onPopoverLoadFinishInRootWnd(function(name,url){
    if(name="pop1"){
        alert("浮动窗口pop1加载完成!");
    }
});
appcan.window.preOpenStart() //开始浮动窗口的预加载

说明:

popOver的预加载必须要与appcan.window.open中的type=64配合:即open时有此type方可对应使用预加载。开始popOver(浮动窗口)的预加载。即一个窗口中需要有多个浮动窗口,可以让这些浮动窗口预先加载出来。
其执行过程:A窗口打开B窗口,B窗口中需要预加载多个浮动窗口。那么A窗口中执行appcan.window.open时,其type参数需要为64配合使用,即open时有此type,B窗口方可使用预加载。此时在B窗口中,会等所有预加载的浮动窗口都加载完毕(不包括异步获取网络数据),方才显示B窗口。预加载的浮动窗口的开启函数,即appcan.window.openPopover,需要放置于appcan.window.preOpenStart和appcan.window.preOpenFinish之间。

参数:

JS SDK版本支持:

1.0.0+

例子:

//A窗口打开B窗口代码需要type为64
appcan.window.open("preOpen","preOpen.html",10,64); 
或者
appcan.window.open({
    name:"preOpen",
    data:"preOpen.html",
    type:64//此为必须
}); 


//B窗口即preOpen.html
appcan.ready(function() {

appcan.window.preOpenStart();

    appcan.window.openPopover({
        name:"content1",
        url:"list/lv_thickline_multi_content.html",
        top:200,
        left:0,
        height:200
    });
    appcan.window.openPopover({ 
        name:"content2",
        url:"http://wap.3g2win.com",
        top:50,
        left:0,
        height:200
    });
    appcan.window.openPopover({
        name:"content3",
        url:"list/lv_thickline_icon_sub_angle_content.html",
        top:400,
        left:0,
        height:200
    });
    appcan.window.preOpenFinish();
});
appcan.window.preOpenFinish() //结束浮动窗口的预加载

参数:

JS SDK版本支持:

1.0.0+

例子:

appcan.window.preOpenFinish();
appcan.window.windowForward(animId,animDuration) //在多窗口机制中,前进到下一个window

(前提是有打开的window窗口)

参数:

animId:动画类型Id
    0: 无动画
    1: 从左向右推入
    2: 从右向左推入
    3: 从上向下推入
    4: 从下向上推入
    5: 淡入淡出
    6: 左翻页
    7: 右翻页
    8: 水波纹
    9: 由左向右切入
     10: 由右向左切入
      11: 由上先下切入
      12: 由下向上切入
      13: 由左向右切出
      14: 由右向左切出
      15: 由上向下切出
      16: 由下向上切出
animDuration:动画持续时长,单位为毫秒,默认为260毫秒

JS SDK版本支持:

1.0.0+

例子:

appcan.window.windowForward(0,200);
appcan.window.windowBack(animId,animDuration) //在多窗口机制中,用于返回上一个window

比如在Awindow中uexWindow.open了Bwindow,那么在Bwindow中返回Awindow就可使用此方法。

参数:

animId:动画类型Id
    0: 无动画
    1: 从左向右推入
    2: 从右向左推入
    3: 从上向下推入
    4: 从下向上推入
    5: 淡入淡出
    6: 左翻页
    7: 右翻页
    8: 水波纹
    9: 由左向右切入
     10: 由右向左切入
      11: 由上先下切入
      12: 由下向上切入
      13: 由左向右切出
      14: 由右向左切出
      15: 由上向下切出
      16: 由下向上切出
animDuration:动画持续时长,单位为毫秒,默认250毫秒

JS SDK版本支持:

1.0.0+

例子:

appcan.window.windowBack(0,200);
还需要帮助吗? 联系我们
最新更新 13th Jun 2017