AppCan uexWindow

uexWindow1、简介1.1window.uexOnload1.2浮动窗口1.3多窗口之间的通讯1.4多窗口通讯之订阅发布模式1.5窗口侧边栏菜单效果(抽屉效果)2、API概览2.1、方法open打开窗口close关闭窗口forward前进到下一个页面back返回上一个页面pageForward前进到下一个页面pageBack返回上一个页面windowForward前进到下一个窗口windowBack返回到上一个窗口showSoftKeyboard弹出软键盘hideSoftKeyboard关闭软键盘alert弹出alert对话框confirm弹出confirm对话框prompt弹出prompt对话框actionSheet弹出菜单列表setReportKey设置当前页面是否拦截某个按键setWindowFrame移动当前窗口位置openSlibing打开一个兄弟窗口closeSlibing关闭一个兄弟窗口showSlibing显示兄弟窗口evaluateScript执行js脚本evaluatePopoverScript在浮动窗口中执行js脚本evaluateMultiPopoverScript在多页面浮动窗口中执行js脚本setSwipeRate设置左右手势的灵敏度toast弹出消息提示框closeToast关闭消息提示框openPopover打开浮动窗口closePopover关闭浮动窗口preOpenStart开始浮动窗口的预加载preOpenFinish结束浮动窗口的预加载setPopoverFrame更改浮动窗口的位置和大小openMultiPopover打开多页面浮动窗口closeMultiPopover关闭多页面浮动窗口setSelectedPopOverInMultiWindow设置多页面浮动窗口跳转到的子页面窗口的索引setMultiPopoverFrame更改多页面浮动窗口的位置和大小bringToFront置顶当前浮动窗口sendToBack置底当前浮动窗口insertAbove将当前浮动窗口插入到指定浮动窗口之上insertBelow将当前浮动窗口插入到指定浮动窗口之下bringPopoverToFront置顶指定浮动窗口sendPopoverToBack置底指定浮动窗口insertPopoverAbovePopover将指定浮动窗口插入到另一浮动窗口之上insertPopoverBelowPopoverinsertWindowAboveWindow将指定窗口插入到另一窗口之上insertWindowBelowWindow将指定窗口插入到另一窗口之下setWindowHidden设置当前窗口显示和隐藏toggleSlidingWindow打开侧滑窗口setSlidingWindow设置侧滑窗口setSlidingWindowEnabled设置侧滑窗口是否可用setMultilPopoverFlippingEnbaled设置控件是否响应滑动事件setOrientation设置屏幕方向setWindowScrollbarVisible设置滚动条的显示和隐藏createProgressDialog创建全局对话框destroyProgressDialog销毁全局对话框postGlobalNotification发送全局消息subscribeChannelNotification注册接收全局消息的监听器publishChannelNotification发送全局消息getState获取当前窗口处于前台还是后台statusBarNotification发送消息到状态栏beginAnimition开始设置动画的相关参数setAnimitionDelay设置动画延迟执行时间setAnimitionDuration设置动画持续时间setAnimitionCurve设置动画曲线类型setAnimitionRepeatCount设置动画重复次数setAnimitionAutoReverse设置动画结束后自动恢复位置和状态makeTranslation设置移动动画makeScale设置伸缩动画makeRotate设置旋转动画makeAlpha设置透明度动画commitAnimition提交动画设置并开始执行动画getBounce获取网页弹动状态setBounce设置是否支持网页弹动notifyBounceEvent注册接收弹动事件showBounceView显示弹动效果resetBounceView设置弹动效果结束后显示的网页setBounceParams设置弹动参数hiddenBounceView隐藏弹动效果getUrlQuery获取加载页面时传入的参数setStatusBarTitleColor设置状态条上字体的颜色getSlidingWindowState获取侧滑窗口显示情况setAutorotateEnable获取侧滑窗口显示情况setIsSupportSlideCallback设置网页是否支持滑动的相关监听方法disturbLongPressGesture阻碍当前网页长按手势setAutorotateEnable获取侧滑窗口显示情况setHardwareEnable设置窗口的硬件加速setPopHardwareEnable设置Popover的硬件加速功能reload重载当前页面reloadWidgetByAppId根据appId重载widget2.2回调方法cbConfirm弹出confirm对话框的回调方法cbPrompt弹出prompt对话框的回调方法cbActionSheet弹出菜单列表的回调方法cbGetState获取窗口是否处于前台的回调方法cbPageBack返回到上一个页面的回调方法cbPageForward前进到下一个页面的回调方法cbOpenMultiPopover打开多页面浮动窗口的回调方法cbGetUrlQuery获取参数时的回调方法cbBounceState获取网页弹动状态的回调方法cbSlidingWindowState获取侧滑窗口显示情况的回调方法2.3监听方法uexOnload网页加载完成时的回调方法onSlipedUpward上滑的监听方法，内容超过一屏时有效onSlipedDownward下滑的监听方法，内容超过一屏时有效onSlipedUpEdge滑到顶部的监听方法，内容超过一屏时有效onSlipedDownEdge滑到底部的监听方法，内容超过一屏时有效onAnimationFinish动画执行完成的监听方法，只对浮动窗口有效onSetWindowFrameFinish当前窗口位置移动完成的监听方法onSwipeRight向右滑动的监听方法onSwipeLeft向左滑动的监听方法onBounceStateChange弹动状态改变的监听方法onGlobalNotification全局消息的监听方法onKeyPressed按键事件的监听方法onStateChange窗口前后台状态变化的监听方法onPopoverLoadFinishInRootWnd浮动窗口加载完成的监听方法3术语表WindowAnimationId窗口动画Id1、简介窗口对象。窗口对象是实现多窗口机制的基本单元。使用窗口对象构建HybridApp，在性能方面更加接近NativeApp的体验。AppCan平台中，维护了一个窗口堆栈，每个窗口以唯一的窗口名字来区别。窗口名字是通过uexWindow.open来赋值的。然而有一个窗口是比较特殊的，即加载起始页的窗口，因为起始页是由config.xml中配置的，无法进行窗口名的赋值，因此，AppCan对加载起始页的窗口统一命名为’root’，也就是说，其它通过uexWindow.open开启的窗口，不能再命名为’root’。1.1window.uexOnload窗口加载完毕后平台将触发此方法。类比window.onload方法，都是html页面加载完成之后触发的方法。区别是，window.uexOnload方法会晚于window.onload方法，原因是window.uexOnload需要等待AppCan扩展对象，即’uex’前缀的对象初始化完毕。事件加载完成之后，可以安全的使用uex扩展对象。1.2浮动窗口主窗口之上可以有多个浮动窗口，即浮动窗口是附属于某个主窗口的。主窗口关闭后，其上所有浮动窗口也都会关闭。所有的窗口都有唯一的名字，通过uexWindow.open打开的是一个主窗口，浮动窗口则通过uexWindow.openPopover创建。一个主窗口上的多个浮动窗口名字是唯一的，但不同主窗口上的浮动窗口名字可以相同。浮动窗口可以有弹动效果，可以有数学变化：放大，旋转，移动等。浮动窗口能够解决的事情很多，比如解决手机浏览器不支持局部DIV滚动,上下拉刷新特效，抽屉特效等问题。1.3多窗口之间的通讯窗口之间的通讯，比如从网络获取一个数据，根据返回的数据，让其它窗口执行相应的变化，这就需要用到窗口间通讯机制。主窗口之间通讯:uexWindow.evaluateScript(winName,type,script)主窗口与浮动窗口之间通讯:uexWindow.evaluateScript(winName,type,script);uexWindow.evaluatePopoverScript(winName,type,script);最后一个参数script，是目标窗口的执行脚本。脚本形参限定为数字和字符串。如果是特殊字符和汉字，则无法传递，可以通过window.localStorage暂存数据，在执行脚本的目标窗口中获取localStorage。1.4多窗口通讯之订阅发布模式调用接口subscribeChannelNotification订阅一个频道，注册监听函数。在任何窗口（包括主窗口，浮动窗口，多页面浮动窗口）调用publishChannelNotification接口发布消息，对应频道的所有订阅者，将收到消息，回调函数将被调用，并传入相应的参数.1.5窗口侧边栏菜单效果(抽屉效果)调用setSlidingWindow接口实现侧边栏菜单效果。手势滑动实现侧边栏菜单的打开和关闭功能。相关接口：setSlidingWindowEnabled，toggleSlidingWindow2、API概览2.1、方法open打开窗口uexWindow.open(windName,dataType,data,animID,w,h,flag,animDuration,extras)说明:打开一个新窗口，如果窗口名字相同，则会覆盖相同窗口名字的页面内容。参数:参数名称参数类型是否必选说明windNameString是窗口名字，可为空，不能为”root”，若已经打开过该名字的窗口，则直接跳转至该窗口。dataTypeNumber是窗口载入的数据的类型，0：url方式载入；1：参数名称参数类型是否必选说明html内容方式载入dataString是url或html数据，支持“wgtroot://”协议头，此协议头用于某些将项目部署在服务器上的appcan应用，在应用执行过程中加载本地网页用。当dataType为0时，url支持相对路径、绝对路径。其中，当url以“wgtroot://”协议开头时，支持从服务器网页中打开本地应用沙箱中相应widget目录下的网页文件。例如：当前窗口加载的是服务器上的网页，如果在xxx.html页面中open一个窗口时，传入的data为“wgtroot://index.html”,那么本次open执行时，引擎将会到本应用沙箱目录的widget路径下去寻找此页