AppCan JS-SDK

AppCanIDE开发与使用说明-JSSDK培训部AppCanjavascriptsdk是appcan根据需求封装的一个开发库，对底层的接口进行更高层的封装，能让开发者更快速、高效的开发更加稳定的项目。该库依赖backbone、zepto、underscore封装的。AppCanJSSDK介绍目录浮动窗口本地存储网络请求设备模块窗口模块窗口模块窗口模块窗口模块打开一个新的窗口appcan.window.open(name,data,aniId,type,dataType,width,height,animDuration)•name:新窗口的的名称，如果窗口存在直接打开，如果不存在先创建然后打开•data:新窗口填充的数据•aniId:动画类型Id•type:窗口类型•dataType:新窗口填充的数据类型•width:要打开的窗口的宽•height:要打开的窗口的高•animDuration:动画执行时间窗口模块范例以url形式打开一个index页面，从左向右推入，并且打开窗口时对页面做强制刷新appcan.window.open(“index”,‘’,‘1’,‘4’,‘0’,0,0,2000);窗口模块范例参数还可以以对象的形式传参{name:,data:,dataType:,aniId:,type:,width:,height:,animDuration:}关闭当前窗口appcan.window.close(aniId,animDuration)窗口模块开启页面弹动效果如果调用该方法，则该webView具有弹动效果appcan.window.enableBounce()禁用页面弹动效果如果调用该方法，则该webView不具有弹动效果appcan.window.disableBounce()设置页面弹动类型前提是开启webView的弹动设置，如果没有开启调用了该方法则会默认开启页面弹动效果appcan.window.setBounceType(type,color,flag,callback)窗口模块设置上下弹动效果appcan.window.setBounce(bounceType,startPullCall,downEndCall,upEndCall,color,imgSettings)•bonceType:弹动的类型0:无任何效果1:颜色弹动效果2:设置图片弹动•startPullCall:开始滑动时触发回调•downEndCall:当弹动类型设置为下边界弹动时，页面到了下边界则会触发该回调•upEndCall:当弹动类型设置为上边界弹动时，页面到了上边界则会触发该回调•color:如果超过了该边界显示的背景颜色•imgSettings:如果超过了该边界，并且想要设置显示的内容包括图片文字则设置该参数窗口模块打开一个toast弹出窗口appcan.window.openToast(msg,duration,position,type)msg:toast要显示的内容duration:toast显示的时间position:toast显示在屏幕中的位置type:toast的类型//0:没有进度条1:有进度条关闭现在显示的toastappcan.window.closeToast()窗口模块弹出一个确认弹出窗口,如果只有一个按钮弹出是警告框，如果是一个以上的按钮弹出的是提示框appcan.window.alert(title,content,buttons,callback)弹出一个提示框appcan.window.Confim(title,content,buttons,callback)弹出一个可以输入内容的提示框appcan.window.prompt(title,content,buttons,callback)窗口模块打开一个弹出框appcan.window.openPopover(name,dataType,url,data,left,top,width,height,fontSize,type,bottomMargin)关闭指定的弹出窗口appcan.window.closePopover(name)重置指定弹出窗口的大小、位置appcan.window.resizePopover(name,left,top,width,height)窗口模块订阅一个频道，如果有消息发给该频道，则会执行响应的回调appcan.window.subscribe(channelId,callback)channelId:订阅的的频道Idcallback(msg):当有消息发来的时候执行的对调，msg是传来的消息向指定通道发送消息appcan.window.publish(channelId,msg)channelId:发送指定消息的通道msg:要发送的消息内容浮动窗口浮动窗口浮动窗口打开一个浮动窗口如果存在则直接打开,如会在页面中查找id的元素，把id元素的宽高指定为浮动窗口的宽高，把id元素的font-size设置为id元素的font-sizeappcan.frame.open(id,url,left,top,name,index,change)•id:要打开浮动窗口的名称•url:浮动窗口要加载的页面的地址,如果url是一个数组则打开多页面浮动窗口•left:浮动窗口距离左边的距离•top:浮动窗口距离上边的距离•name:强制改变打开窗口的名称•index:设置选中的多页面窗口的默认索引•change:如果多页面浮动窗口改变时会触发该回调关闭指定的浮动窗口appcan.frame.close(name)•name:浮动窗口的名字浮动窗口根据指定的元素弹出一个跟这个元素样式相同的浮动窗口appcan.frame.resize(id,url,left,top,name)id:要重置的浮动窗口的名称url:弹出浮动窗口加载的urlleft:要重置浮动窗口距离左边的距离top:要重置的浮动窗口距离上边的距离name:要强制重载的浮动窗口名称把指定的浮动窗口设置为最上层appcan.frame.bringToFront(name)name:要设置的弹出层的名称浮动窗口打开多页面浮动窗口appcan.frame.openMulti(popName,content,dataType,left,top,width,height,fontSize,flag,indexSelected)popName:打开新窗口的名称content:要传入的数据dataType:窗口载入的数据的类型left:距离左边界的距离top:距离上边界的距离width:窗口的宽height:窗口的高fontSize:字体的大小flag:窗口类型indexSelected:默认显示的索引项，默认显示第一项关闭多页面浮动窗口appcan.frame.closeMulti(popName)本地存储本地存储本地存储要设置的键值对appcan.locStorage.setVal（key，Val）•key:要保存的键，key如果是数组就会把数组中每个键值对都保存起来，如果是对象则会把对象里面每个键值对都保存起来。•val:要保存对应的值清除localStorage中对应的值appcan.locStorage.remove(key)获取localStorage中，保存的所有键值appcan.locStorage.keys()获取或者设置localStorage的值appcan.locStorage.val(key,value)本地存储//设置一个color到本地存储中appcan.locStorage.setVal('color','red');//清除保存的颜色值appcan.locStorage.remove('color');范例网络请求网络请求网络请求发起一个ajax请求,并获取相应的内容appcan.request.ajax(options)options:发起ajax的请求的参数，这个必须是一个对象appcan.request.ajax({type:'GET',url:'htt://appcan.cn',data:{name:'appcan'},//添加参数dataType:'html',//期望的返回类型timeout:300,//超时时间success:function(data){alert('data');//获取内容},error:function(xhr,type){alert('Ajaxerror!')}})网络请求发一个httpget请求appcan.request.get(url,[data],success,[dataType])•url:要请求的地址•data:该参数不是必须的，要传递的参数•success:成功后的回调函数，参考appcan.request.ajax参数中的success•dataType:返回的响应结果的数据类型发起一个httpget请求来获取json数据appcan.request.getJSON(url,[data],success)•url:要获取的json数据的地址•data:要发送请求的参数•success:成功后的回调网络请求发起一个httpPost请求appcan.request.post(url,[data],success,[dataType])•url:要请求的地址•data:要发出的请求的参数•success:请求的成功的回调•dataType:返回的响应结果的数据类型序列化表单内容并提交表单appcan.request.postForm(selector,success,error)•selector:表单的css选择器，或者是form元素如果想要传文件的话该input元素必须包含一个data-ispath=true属性•success(data):表单提交成功后的回调,data服务器端的返回值•error(err):表单提交失败的时候的回调,err错误对象设备模块设备模块设备模块使设备震动appcan.device.vibrate(millisecond)millisecond:设备震动的时常单位毫秒停止设备震动appcan.device.cancelVibrate()设备模块获取设备对应id的信息appcan.device.getInfo(infoId,callback)infoId:相关信息idCallback（err,data,dataType,optId）获取所有相关的设备信息appcan.device.getDeviceInfo(callback)callback(deviceInfo,singleInfo,i,len,completeCount):•deviceInfo当前已经获得的设备信息•singleInfo正在读取的设备信息•i设备信息id•len设备信息总数•completeCount已经获得的设备信息数感谢语Thinksforyourlistening!地址：北京市海淀区海淀中街15号远中悦莱大厦3层305U邮编：100080电话：86-10-57580888传真：86-10-57580777服务热线：400-040-1766网址：