APICloud常用方法介绍 – ben - 生命不止，贲流不息！

actionSheet底部弹出框：

api.actionSheet({  
    title: '底部弹出框测试',  
    cancelTitle: '这里是取消按钮',  
    destructiveTitle: '红色警告按钮',  
    buttons: ['1','2','3']  
},function(ret,err){  
    api.alert({  
        msg: '你刚点击了'+ret.buttonIndex  
    });  
});

confirm对话框：

api.confirm({  
    title: 'testtitle',  
    msg: 'testmsg',  
    buttons:[ '确定', '取消']  
},function(ret,err){  
    if(ret.buttonIndex == 1){  
        api.alert({msg: '点击了确定'});  
    }  
});

alert对话框：

api.alert({  
    title: 'testtitle',  
    msg: 'testmsg',  
    buttons:[ '确定']  
},function(ret,err){  
    if(ret.buttonIndex == 1){  
        api.alert({msg: '点击了确定'});  
    }  
});

prompt带输入框的对话框

api.prompt({  
    buttons:['确定', '取消']  
},function(ret,err){  
    if(ret.buttonIndex == 1){  
        api.alert({msg:ret.text});  
    }  
});

ajax:异步请求

api.ajax({  
    url: 'http://192.168.1.101:3101/upLoad',  
    method: 'post',  
    cache: false,  
    timeout: 30,  
    dataType: 'json',  
    returnAll:false,  
    data:{  
        values: {name: 'haha'},  
        files: {file: 'fs://a.gif'}  
    }  
},function(ret,err){  
    if (ret) {  
        var urlJson = JSON.stringify(ret);  
        api.alert({msg: urlJson});  
    }else {  
        api.alert({  
            msg:('错误码：'+err.code+'；错误信息：'+err.msg+'网络状态码：'+err.statusCode)  
        });  
    };  
});

animation动画

api.animation ({  
    name: 'page1',//子窗口名称  
    delay: 1000,  
    duration: 3000,  
    curve: 'easeIn',//动画曲线类型  
    repeatCount: 2,  
    autoreverse: true,//一次动画结束后是否自动反转动画  
    alpha: 0.6,  
    translation:{//平移参数  
        x: 0,//x轴上的平移距离  
        y: 100,  
        z: 0  
    },   
    scale:{  
        x: 1.2,//<span style="font-family: Arial, Helvetica, sans-serif;">x轴上的放大倍率</span>  
        y: 1,  
        z: 1  
    },  
    rotation:{  
        degree:45,//旋转角度  
        x: 0,  
        y: 0,  
        z: 1  
    }  
}, function() {  
    api.alert({msg: '动画结束'});  
});

bringFrameToFront：调整子窗口到前面

api.bringFrameToFront({  
    from:'page1',  
    to:'page2'  
});

call：拨打电话

api.call({  
    type: 'tel_prompt',  
    number: '10086'  
});

cancelDownload：取消文件下载

var url = 'http://file05.daimg.com/2013/photo/1401/DAimG_2014011335974260TA24.rar';  
api.cancelDownload ({  
    url: url  
});

closeFrame：关闭子窗口

api.closeFrame({  
    name: 'page2'  
});

closeFrameGroup：关闭窗口组

api.closeFrameGroup({  
    name: 'group1'  
});

download文件下载：

var url = 'http://file05.daimg.com/2013/photo/1401/DAimG_2014011335974260TA24.rar';  
api.download({  
    url: url,  
    savePath: 'fs://test.rar',//下载后的保存路径，如果为空会自动创建保存路径  
    report: true,//是否上报  
    cache: true,//是否缓存  
    allowResume:true//是否支持断点续传  
},function(ret,err){  
    if (ret) {  
        var value = ('文件大小：'+ret.fileSize+'；下载进度：'+ret.percent+'；下载状态'+ret.state+'存储路径: '+ret.savePath);  
    } else{  
        var value = err.msg;  
    };  
});

execScript在指定窗口中执行脚本：

api.execScript({  
    name: 'page1',  
    script: 'exec();'//执行的JS方法  
});

getLocation获取位置信息

api.getLocation(  
    function(ret, err){  
        if(ret.status){  
            var lat = ret.latitude;//纬度  
            var lon = ret.longitude;//经度  
            var t = ret.timestamp; //更新时间  
            var str = '经度：'+ lon +'<br>';  
            str += '纬度：'+ lat +'<br>';  
            str += '更新时间：'+ t +'<br>';  
        } else{  
            api.alert({msg:err.msg});  
        }  
    }  
);

getPicture获取图片

api.getPicture({  
    sourceType: 'library',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">图片源类型</span>  
    encodingType: 'png',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">编码格式</span>  
    mediaValue: 'pic',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">媒体类型</span>  
    destinationType: 'url',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">返回数据类型</span>  
    allowEdit: true,//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">是否可以编辑</span>  
    quality: 50,//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">图片质量</span>  
    targetWidth:100,//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">压缩后的图片宽度</span>  
    targetHeight:100,//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">压缩后的图片高度</span>  
    saveToPhotoAlbum: false//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">是否保存到相册</span>  
}, function(ret, err){   
    if (ret) {  
        api.alert({msg:ret.data});  
    } else{  
        api.alert({msg:err.msg});  
    };  
});

mail发送邮件

var recip = 'test@163.com';  
var sub = '邮件测试';  
var body = '这是一封测试用的邮件';  
var attach = 'widget://a.txt';  
api.mail({  
    recipients: [recip],//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">收件人</span>  
    subject: sub,//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">邮件主题</span>  
    body: body,//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">邮件内容</span>  
    attachments: [attach]//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">附件地址</span>  
}, function(ret, err){  
    if(ret.status){  
        api.alert({  
            msg: '发送成功'  
        });  
    } else{  
        api.alert({  
            msg: '发送失败'  
        });  
    }  
});

openApp打开手机上的其他应用

api.openApp({//此方法只使用与Android应用  
    androidPkg: 'android.intent.action.VIEW',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">目标应用的包名或action（Android平台使用）</span>  
    mimeType: 'text/html',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">指定目标应用的响应数据类型</span>  
    uri: 'http://www.baidu.com'//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">指定目标应用响应的uri</span>  
},function(ret,err){  
    var msg = JSON.stringify(ret);  
    api.alert({  
        title: 'openApp',  
        msg: msg,  
        buttons: ['确定']  
    });  
});

openFrame打开子窗口

api.openFrame({  
    name: 'page2',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">窗口名字</span>  
    url: './page2.html',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">请求地址</span>  
    rect:{//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">窗口区域</span>  
        x:0,  
        y:0,  
        w:320,  
        h:480  
    },  
    pageParam: {name: 'test'},//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">页面参数</span>  
    bounces: true,//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">页面是否弹动</span>  
    opaque: false,//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">页面是否不透明</span>  
    bgColor: 'rgba(0,0,0,0)',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">背景色</span>  
    vScrollBarEnabled:true,//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">是否显示垂直滚动条</span>  
    hScrollBarEnabled:true//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">是否显示<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">水平</span>滚动条</span>  
});

openFrameGroup打开窗口组

api.openFrameGroup ({  
    name: 'group1',  
    background:'#fff',  
    scrollEnabled:false,  
    rect:{x:0, y:0, w:320, h:240},  
    index:0,//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">默认显示的页面索引</span>  
    frames://<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">子窗口数组</span>  
    [{  
        name: 'frame1',   
        url: 'frame1.html',   
        pageParam:{},   
        bounces:true,   
        opaque:true,  
        bgColor: '#fff',   
        vScrollBarEnabled:true,  
        hScrollBarEnabled:false  
    },{  
        name: 'frame2',   
        url: 'frame2.html',   
        pageParam:{},   
        bounces:true,   
        opaque:true,  
        bgColor: '#fff',   
        vScrollBarEnabled:true,  
        hScrollBarEnabled:false  
    }]  
}, function(ret, err){  
    var name = ret.name;  
    var index = ret.index;  
});

openPicker打开时间选择器

api.openPicker({  
    type: 'date_time',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">拾取器类型</span>  
    date: '2014-05-01 12:30',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">时间格式化字符串，格式yyyy-MM-dd HH:mm</span>  
    title:'选择时间'//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">标题</span>  
},function(ret,err){  
    var year = ret.year;  
    var month = ret.month;  
    var day = ret.day;  
    var hour = ret.hour;  
    var minute = ret.minute;  
    if (type == 'date') {  
        var value = year+'年'+month+'月'+day+'日';  
    } else if (type == 'time') {  
        var value = hour+'时'+minute+'分';  
    } else if (type == 'date_time') {  
        var value = year+'年'+month+'月'+day+'日'+hour+'时'+minute+'分';  
    }  
});

openSlidLayout打开侧滑式布局

api.openSlidLayout ({  
    type: 'all',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">侧滑类型（left：左侧滑、right：右侧滑、all：左右侧滑）</span>  
    leftEdge:80,//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">左侧滑时，侧滑window停留时露出的宽度</span>  
    rightEdge:60,  
    fixedPane: {//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">底部固定层window</span>  
        name: 'frame1',   
        url: 'frame1.html',   
        bgColor: '#fff',   
        bounces:true,   
        opaque:true,   
        vScrollBarEnabled:true,  
        hScrollBarEnabled:false  
    },  
    slidPane: {  
        name: 'frame1',   
        url: 'frame1.html',   
        bgColor: '#fff',   
        bounces:true,   
        opaque:true,   
        vScrollBarEnabled:true,  
        hScrollBarEnabled:false  
    }  
}, function(ret){  
    var type = ret.type;  
    if (type == 'left') {  
  
    } else {  
  
    }  
});

openSlidPane侧滑

api.openSlidPane ({  
    type: 'left'//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">侧滑类型，left或right，不能为空</span>  
});

openWidget打开Widget

api.openWidget({  
    id: 'UZ00000001',  
    animation: {  
        type: 'flip',  
        subType: 'from_bottom',  
        duration: 500  
    }  
}, function(ret, err){  
    if(ret){  
    } else{  
        api.alert({msg:err.msg});  
    }  
});

openWin打开窗口，如果窗口已存在，则会把窗口显示到最前面

api.openWin({  
    name: 'page1',  
    url: './page1.html',  
    pageParam: {name: 'test'},  
    bounces: true,  
    opaque: false,  
    bgColor: 'rgba(0,0,0,0)',  
    vScrollBarEnabled:true,  
    hScrollBarEnabled:true,  
    animation: {  
        type: 'flip',  
        subType: 'from_bottom',  
        duration: 500  
    }  
});

parseTapmode解析元素tapmode属性，优化点击事件处理
api.parseTapmode();

readFile读取文本文件

api.readFile({  
    path:'fs://a.txt'  
}, function(ret, err){  
    if(ret.status){  
        api.alert({msg:ret.data});//data<span style="color: rgb(147, 161, 161); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 13px; line-height: 18.571428298950195px; white-space: pre-wrap; background-color: rgb(238, 238, 238);">文件内容</span>  
    } else{  
        api.alert({  
            msg: '错误码: '+err.code+'错误信息'+err.msg<span style="color: rgb(42, 161, 152); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 13px; line-height: 18.571428298950195px; white-space: pre-wrap; background-color: rgb(238, 238, 238);">//</span><span style="font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif;">msg:</span><span style="color: rgb(42, 161, 152); font-family: Menlo, Monaco, Consolas, 'Courier New', monospace; font-size: 13px; line-height: 18.571428298950195px; white-space: pre-wrap; background-color: rgb(238, 238, 238);">错误描述</span>  
        });  
    }  
});

refreshHeaderLoadDone通知顶部刷新数据加载完毕

api.refreshHeaderLoadDone();

removeEventListener删除事件:

api.removeEventListener({  
    name: 'online'  
});

sendFrameToBack调整子窗口到后面

api.sendFrameToBack ({//调整page1到page2的后面即将page2放在最page1上  
    from: 'page1',  
    to: 'page2'//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">窗口名字，指定时调整窗口到此窗口后面，否则调整到最后面</span>  
});

setFrameAttr设置子窗口属性：

api.setFrameAttr({  
    name: 'page2',  
    rect:{  
        x:0,  
        y:0,  
        w:320,  
        h:480  
    },  
    bounces: true,  
    opaque: true,  
    bgColor: '#fff',  
    vScrollBarEnabled:true,  
    hScrollBarEnabled:true  
});

setFrameGroupAttr设置窗口组属性

api.setFrameGroupAttr({  
    name: 'group1',  
    hidden:true  
});

setFrameGroupIndex设置窗口组当前可见子窗口

api.setFrameGroupIndex ({  
    name: 'group1',  
    index:2,//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">子窗口索引</span>  
    scroll:true//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">是否平滑滚动至目标窗口</span>  
});

setFullScreen设置是否全屏

api.setFullScreen({fullScreen:true});

setRefreshHeaderInfo显示顶部刷新

api.setRefreshHeaderInfo({  
    visible: true,  
    loadingImg: 'widget://image/refresh.png',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">刷新图片地址</span>  
    bgColor: '#ccc',  
    textColor: '#fff',  
    textDown: '下拉刷新...',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">下拉文字描述</span>  
    textUp: '松开刷新...',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">松开时文字描述</span>  
    showTime: true//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">是否显示更新时间</span>  
}, function(ret, err){  
  
});

showFloatBox展示一个悬浮框，浮动在屏幕上，点击时关闭当前widget：

api.showFloatBox ({  
    iconPath: 'widget://image/icon.png',//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">展示在悬浮框中的图片地址</span>  
    duration: 3000//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">自动消隐时长。在该时长内不发生触摸悬浮框行为，悬浮框自动消隐至半透状态</span>  
});

showProgress显示进度提示框：

api.showProgress({  
    style: 'default',  
    nimationType: 'fade',  
    title: '努力加载中...',  
    text: '先喝杯茶...',  
    modal: false//<span style="color: rgb(128, 128, 128); font-family: ff-tisa-web-pro-1, ff-tisa-web-pro-2, 'Lucida Grande', 'Helvetica Neue', Helvetica, Arial, 'Microsoft YaHei', 'Hiragino Sans GB', 'Hiragino Sans GB W3', 'WenQuanYi Micro Hei', sans-serif; font-size: 14px; line-height: 20px;">是否模态</span>  
});

writeFile写入文件：

api.writeFile({  
    path: 'fs://a.txt',  
    data: 'writeFile测试内容'  
}, function(ret, err){  
    var status = ret.status;  
    if(status){  
        api.alert({msg:'写入文件成功'});  
    } else{  
        api.alert({msg:err.msg});  
    }  
});

removeLaunchView移除启动图。若config.xml里面配置autoLaunch为false，则启动图不会自动消失，直到调用此方法移除。

api.removeLaunchView();

actionSheet底部弹出框：

confirm对话框：

alert对话框：

prompt带输入框的对话框

ajax:异步请求

animation动画

bringFrameToFront：调整子窗口到前面

call：拨打电话

cancelDownload：取消文件下载

closeFrame：关闭子窗口

closeFrameGroup：关闭窗口组

download文件下载：

execScript在指定窗口中执行脚本：

getLocation获取位置信息

getPicture获取图片

mail发送邮件

openApp打开手机上的其他应用

openFrame打开子窗口

openFrameGroup打开窗口组

openPicker打开时间选择器

openSlidLayout打开侧滑式布局

openSlidPane侧滑

openWidget打开Widget

openWin打开窗口，如果窗口已存在，则会把窗口显示到最前面

readFile读取文本文件

refreshHeaderLoadDone通知顶部刷新数据加载完毕

removeEventListener删除事件:

sendFrameToBack调整子窗口到后面

setFrameAttr设置子窗口属性：

setFrameGroupAttr设置窗口组属性

setFrameGroupIndex设置窗口组当前可见子窗口

setFullScreen设置是否全屏

setRefreshHeaderInfo显示顶部刷新

showFloatBox展示一个悬浮框，浮动在屏幕上，点击时关闭当前widget：

showProgress显示进度提示框：

writeFile写入文件：

removeLaunchView移除启动图。若config.xml里面配置autoLaunch为false，则启动图不会自动消失，直到调用此方法移除。

留言 取消回复

留言取消回复