HTML5 API Reference

HTML5+APIReferenceuiUI模块管理应用界面，用于操作加载HTML页面的原生窗口，调用系统原生控件等。由于此模块功能太多，现已根据功能分拆更新为Key、NativeUI、Navigator、Webview等，并对接口和功能做了一些优化调整，请使用新API。方法：alert:弹出系统提示框closeSplashscreen:关闭程序启动界面closeWindow:关闭原生窗口confirm:弹出系统确认对话框createView:创建新的原生控件对象createWaiting:创建等待对话框createWindow:创建新的原生窗口enumWindow:枚举所有原生窗口findWindowByName:查找指定名称的窗口getSelfWindow:获取自身窗口isFullscreen:判断应用当前是否全屏模式运行pickDate:弹出日期选择界面pickTime:弹出时间选择界面prompt:弹出系统输入框setFullscreen:设置应用是否全屏模式运行toast:显示自动消失的消息对象：AnimationTypeShow:一组用于定义页面或控件显示动画效果AnimationTypeClose:一组用于定义页面或控件关闭的动画效果DateOption:JSON对象，选择日期界面设置的参数Metrics:JSON对象，窗口实际度量信息NView:原生控件对象，用于操作页面中显示的原生控件NViewDock:原生控件在窗口中停靠的方式NViewOption:JSON对象，原生控件元素要设置的参数NViewPosition:原生控件在窗口中显示的位置NWaiting:NWaiting是等待控件对象，用于在界面中显示原生等待窗口NWaitingOption:JSON对象，原生等待控件要设置的参数NWindow:NWindow是窗口对象，用于操作加载html页面的原生窗口NWindowEvent:窗口事件对象NWindowOption:JSON对象，原生窗口设置参数的对象PullToRefreshOption:JSON对象，原生窗口设置参数的对象TimeOption:JSON对象，选择时间界面设置的参数ToastOption:JSON对象，系统提示消息框要设置的参数Transform:一组用于定义页面或控件变形的属性，暂不支持Transition:一组用于定义页面或控件转换效果的属性回调方法：AlertCallback:系统提示框确认的回调函数ConfirmCallback:系统确认框操作的回调函数PromptCallback:系统输入框操作的回调函数ToastCallback:系统消息框消失时的回调函数PickDatetimeSuccessCallback:选择日期或时间操作成功的回调函数PickDatetimeErrorCallback:选择日期或时间操作失败的回调函数MetricsCallback:获取控件或窗口实际度量信息回调函数EventCallback:窗口事件的回调函数HistoryQueryCallback:历史记录记录查询的回调函数PullToRefreshCallback:窗口刷新操作的回调函数权限：permissionsUI:{description:访问系统原生窗口}alert弹出系统提示框voidplus.ui.alert(message,alertCB,title,buttonCapture);说明：弹出系统样式提示对话框，可设置弹出对话框的标题、内容、按钮文字。此API非阻塞模式，用户点击提示框上的按钮需通过alertCB回调函数返回。参数：message:(DOMString)必选提示对话框上显示的内容alertCB:(AlertCallback)可选点击提示对话框上按钮后的回调函数title:(DOMString)可选提示对话框上显示的标题buttonCapture:(DOMString)必选提示对话框上按钮的名称返回值：void:无平台支持：Android-2.2+(支持)iOS-4.3+(支持)示例：UIExample//扩展API加载完毕后调用onPlusReady回调函数document.addEventListener(plusready,onPlusReady,false);//扩展API加载完毕，现在可以正常调用扩展APIfunctiononPlusReady(){//弹出提示信息框plus.ui.alert(Plusisready!,function(){alert(UserpressedOK!);},Hell0,OK);}MessagenotificationcloseSplashscreen关闭程序启动界面voidplus.ui.closeSplashscreen();说明：在某些情况下，程序启动后需要较长时间加载数据，为了避免界面显示空白内容，提高用户体验效果，这时可显示启动界面，直到数据加载完成后再关闭启动界面，通常在应用的首界面加载完成并更新显示内容后调用。参数：无返回值：void:无示例：UIExample//扩展API加载完毕后调用onPlusReady回调函数document.addEventListener(plusready,onPlusReady,false);//扩展API加载完毕，现在可以正常调用扩展APIfunctiononPlusReady(){//页面内容加载完成，关闭程序启动界面plus.ui.closeSplashscreen();}MessagenotificationcloseWindow关闭原生窗口voidplus.ui.closeWindow(win,aniClose,duration);说明：关闭已经打开的原生窗口。参数：win:(DOMString)必选要关闭的原生窗口可以是窗口对象，也可以是窗口的name值。aniClose:(AnimationTypeClose)可选关闭原生窗口的动画效果duration:(Number)可选关闭原生窗口的动画持续时间单位为ms，默认为窗口show方法设定的动画时间。返回值：void:无平台支持：Android-2.2+(支持)iOS-4.3+(支持)示例：UIExample//扩展API加载完毕后调用onPlusReady回调函数document.addEventListener(plusready,onPlusReady,false);//扩展API加载完毕，现在可以正常调用扩展APIfunctiononPlusReady(){}functionwinAutoClose(){//打开新窗口varnw=plus.ui.createWindow();//百度主页nw.show();//显示窗口//十秒后自动关闭setTimeout(function(){plus.ui.closeWindow(nw);},10000);}confirm弹出系统确认对话框voidplus.ui.confirm(message,confirmCB,title,buttons);说明：弹出系统样式确认对话框，可设置弹出对话框的标题、内容、按钮数目及其文字。弹出的提示对话框为非阻塞模式，用户点击确认框上的按钮通过confirmCB回调函数返回。参数：message:(DOMString)必选确认对话框上显示的内容confirmCB:(ConfirmCallback)可选点击确认对话框上按钮后的回调函数title:(DOMString)可选确认对话框上显示的标题buttons:(DOMString[])可选确认对话框上显示的按钮数组返回值：void:无平台支持：Android-2.2+(支持)iOS-4.3+(支持)示例：UIExample//扩展API加载完毕后调用onPlusReady回调函数document.addEventListener(plusready,onPlusReady,false);//扩展API加载完毕，现在可以正常调用扩展APIfunctiononPlusReady(){//弹出提示信息框plus.ui.confirm(Areyousureready?,function(i){alert((i==0)?Yes!:No!);},Confirm,[Yes,No]);}MessagenotificationcreateView创建新的原生控件对象NViewplus.ui.createView(identity,options);说明：创建原生窗口显示元素，用于加载新的显示元素。可通过options设置原生窗口显示元素的属性。参数：identity:(DOMString)必选新创建显示元素的标识，需通过原生UI扩展注册options:(NViewOption)可选新打开原生窗口显示元素的参数（如元素宽、高、位置等信息）返回值：NView:NView对象平台支持：Android-2.2+(支持)iOS-4.3+(支持)示例：UIExample//扩展API加载完毕后调用onPlusReady回调函数document.addEventListener(plusready,onPlusReady,false);//扩展API加载完毕，现在可以正常调用扩展APIfunctiononPlusReady(){}functioncreateViewTest(){//打开新窗口varnv=plus.ui.createView('Navigator',{position:'dock',dock:'top'});plus.ui.getSelfWindow().append(nv);//显示窗口}createWaiting创建等待对话框NWaitingplus.ui.createWaiting(title,options);说明：在程序中创建并显示等待对话框。参数：title:(DOMString)可选等待框上显示的提示文字options:(NWaitingOption)可选等待框的显示参数返回值：NWaiting:NWaiting对象平台支持：Android-2.2+(支持)iOS-4.3+(支持)示例：UIExample//扩展API加载完毕后调用onPlusReady回调函数document.addEventListener(plusready,onPlusReady,false);//扩展API加载完毕，现在可以正常调用扩展APIfunctiononPlusReady(){//打开新窗口varw=plus.ui.createWaiting(等待中...);}等待对话框。createWindow创建新的原生窗口NWindowplus.ui.createWindow(url,options);说明：创建原生窗口，用于加载新的系统原生窗口。可通过options设置原生窗口的属性。参数：url:(DOMString)必选创建窗口要打开的页面地址新打开原生窗口要加载html页面地址，可支持本地地址和网络地址。options:(NWindowOption)可选新打开原生窗口的参数（如窗口宽、高、位置等信息）返回值：NWindow:NWindow对象平台支持：Android-2.2+(支持)iOS-4.3+(支持)示例：UIExample//扩展API加载完毕后调用onPlusReady回调函数document.addEventListener(plusready,onPlusReady,false);//扩展API加载完毕，现在可以正常调用扩展APIfunctiononPlusReady(){}functioncreateWinTest(){//打开新窗口varnw=plus.ui.createWindow();//百度主页nw.show();//显示窗口}enumWindow枚举所有原生窗口Array[NWindow]pl