《AppCanueWindow》由会员分享,可在线阅读,更多相关《AppCanueWindow(123页珍藏版)》请在金锄头文库上搜索。
1、uexWindow1、简介1.1 window.uexOnload1.2 浮动窗口1.3 多窗口之间的通讯1.4 多窗口通讯之订阅发布模式1.5 窗口侧边栏菜单效果(抽屉效果)2、API 概览2.1、方法open 打开窗口close 关闭窗口forward 前进到下一个页面back 返回上一个页面pageForward 前进到下一个页面pageBack 返回上一个页面windowForward 前进到下一个窗口windowBack 返回到上一个窗口showSoftKeyboard 弹出软键盘hideSoftKeyboard 关闭软键盘alert 弹出 alert 对话框confirm 弹出 c
2、onfirm 对话框prompt 弹出 prompt 对话框actionSheet 弹出菜单列表setReportKey 设置当前页面是否拦截某个按键setWindowFrame 移动当前窗口位置openSlibing 打开一个兄弟窗口closeSlibing 关闭一个兄弟窗口showSlibing 显示兄弟窗口evaluateScript 执行 js 脚本evaluatePopoverScript 在浮动窗口中执行 js 脚本evaluateMultiPopoverScript 在多页面浮动窗口中执行 js 脚本setSwipeRate 设置左右手势的灵敏度toast 弹出消息提示框clos
3、eToast 关闭消息提示框openPopover 打开浮动窗口closePopover 关闭浮动窗口preOpenStart 开始浮动窗口的预加载preOpenFinish 结束浮动窗口的预加载setPopoverFrame 更改浮动窗口的位置和大小openMultiPopover 打开多页面浮动窗口closeMultiPopover 关闭多页面浮动窗口setSelectedPopOverInMultiWindow 设置多页面浮动窗口跳转到的子页面窗口的索引setMultiPopoverFrame 更改多页面浮动窗口的位置和大小bringToFront 置顶当前浮动窗口sendToBack
4、置底当前浮动窗口insertAbove 将当前浮动窗口插入到指定浮动窗口之上insertBelow 将当前浮动窗口插入到指定浮动窗口之下bringPopoverToFront 置顶指定浮动窗口sendPopoverToBack 置底指定浮动窗口insertPopoverAbovePopover 将指定浮动窗口插入到另一浮动窗口之上insertPopoverBelowPopoverinsertWindowAboveWindow 将指定窗口插入到另一窗口之上insertWindowBelowWindow 将指定窗口插入到另一窗口之下setWindowHidden 设置当前窗口显示和隐藏toggle
5、SlidingWindow 打开侧滑窗口setSlidingWindow 设置侧滑窗口setSlidingWindowEnabled 设置侧滑窗口是否可用setMultilPopoverFlippingEnbaled 设置控件是否响应滑动事件setOrientation 设置屏幕方向setWindowScrollbarVisible 设置滚动条的显示和隐藏createProgressDialog 创建全局对话框destroyProgressDialog 销毁全局对话框postGlobalNotification 发送全局消息subscribeChannelNotification 注册接收全局
6、消息的监听器publishChannelNotification 发送全局消息getState 获取当前窗口处于前台还是后台statusBarNotification 发送消息到状态栏beginAnimition 开始设置动画的相关参数setAnimitionDelay 设置动画延迟执行时间setAnimitionDuration 设置动画持续时间setAnimitionCurve 设置动画曲线类型setAnimitionRepeatCount 设置动画重复次数setAnimitionAutoReverse 设置动画结束后自动恢复位置和状态makeTranslation 设置移动动画makeS
7、cale 设置伸缩动画makeRotate 设置旋转动画makeAlpha 设置透明度动画commitAnimition 提交动画设置并开始执行动画getBounce 获取网页弹动状态setBounce 设置是否支持网页弹动notifyBounceEvent 注册接收弹动事件showBounceView 显示弹动效果resetBounceView 设置弹动效果结束后显示的网页setBounceParams 设置弹动参数hiddenBounceView 隐藏弹动效果getUrlQuery 获取加载页面时传入的参数setStatusBarTitleColor 设置状态条上字体的颜色getSlidi
8、ngWindowState 获取侧滑窗口显示情况setAutorotateEnable 获取侧滑窗口显示情况setIsSupportSlideCallback 设置网页是否支持滑动的相关监听方法disturbLongPressGesture 阻碍当前网页长按手势setAutorotateEnable 获取侧滑窗口显示情况setHardwareEnable 设置窗口的硬件加速setPopHardwareEnable 设置 Popover 的硬件加速功能reload 重载当前页面reloadWidgetByAppId 根据 appId 重载 widget2.2 回调方法cbConfirm 弹出 c
9、onfirm 对话框的回调方法cbPrompt 弹出 prompt 对话框的回调方法cbActionSheet 弹出菜单列表的回调方法cbGetState 获取窗口是否处于前台的回调方法cbPageBack 返回到上一个页面的回调方法cbPageForward 前进到下一个页面的回调方法cbOpenMultiPopover 打开多页面浮动窗口的回调方法cbGetUrlQuery 获取参数时的回调方法cbBounceState 获取网页弹动状态的回调方法cbSlidingWindowState 获取侧滑窗口显示情况的回调方法2.3 监听方法uexOnload 网页加载完成时的回调方法onSlip
10、edUpward 上滑的监听方法,内容超过一屏时有效onSlipedDownward 下滑的监听方法,内容超过一屏时有效onSlipedUpEdge 滑到顶部的监听方法,内容超过一屏时有效onSlipedDownEdge 滑到底部的监听方法,内容超过一屏时有效onAnimationFinish 动画执行完成的监听方法,只对浮动窗口有效onSetWindowFrameFinish 当前窗口位置移动完成的监听方法onSwipeRight 向右滑动的监听方法onSwipeLeft 向左滑动的监听方法onBounceStateChange 弹动状态改变的监听方法onGlobalNotification
11、 全局消息的监听方法onKeyPressed 按键事件的监听方法onStateChange 窗口前后台状态变化的监听方法onPopoverLoadFinishInRootWnd 浮动窗口加载完成的监听方法3 术语表WindowAnimationId 窗口动画 Id1、简介窗口对象。窗口对象是实现多窗口机制的基本单元。使用窗口对象构建 Hybrid App,在性能方面更加接近 Native App 的体验。AppCan 平台中,维护了一个窗口堆栈,每个窗口以唯一的窗口名字来区别。窗口名字是 通过 uexWindow.open 来赋值的。然而有一个窗口是比较特殊的,即加载起始页的窗口,因为起始页是
12、由 config.xml 中配置的,无法进行窗口名的赋值,因此,AppCan 对加载起始页的窗口统一命名为root,也就是说 ,其它通过 uexWindow.open 开启的窗口,不能再命名为root。1.1 window.uexOnload窗口加载完毕后平台将触发此方法。类比 window.onload 方法,都是 html 页面加载完成 之后触发的方法。区别是,window.uexOnload 方法会晚于 window.onload 方法,原因是 window.uexOnload 需要等 待 AppCan 扩展对象,即uex前缀的对象初始化完毕。事件加载完成之后,可以安全的使用 uex 扩
13、展对象。1.2 浮动窗口主窗口之上可以有多个浮动窗口,即浮动窗口是附属于某个主窗口的。主窗口关闭后, 其上所有浮动窗口也都会关闭。所有的窗口都有唯一的名字,通过 uexWindow.open 打开的是一个主窗口,浮动窗 口则通过 uexWindow.openPopover 创建。一个主窗口上的多个浮动窗口名字是唯一的,但不同主窗口上的浮动窗 口名字可以相同。浮动窗口可以有弹动效果,可以有数学变化:放大,旋转,移动等。浮动窗口能够解决的事情 很多,比如解决手机浏览器不支持局部 DIV 滚动, 上下拉刷新特效,抽屉特效等问题。1.3 多窗口之间的通讯窗口之间的通讯,比如从网络获取一个数据,根据返回
14、的数据,让其它窗口执行相应的 变化,这就需要用到窗口间通讯机制。主窗口之间通讯: uexWindow.evaluateScript(winName, type, script)主窗口与浮动窗口之间通讯: uexWindow.evaluateScript(winName, type, script); uexWindow.evaluatePopoverScript(winName, type, script);最后一个参数 script,是目标窗口的执行脚本。脚本形参限定为数字和字符串。如果是 特殊字符和汉字,则无法传递,可以通过 window.localStorage 暂存数据,在执行脚本的目
15、标窗口中获取 localStorage。1.4 多窗口通讯之订阅发布模式调用接口 subscribeChannelNotification 订阅一个频道,注册监听函数。 在任何窗口(包括主窗口,浮动窗口,多页面浮动窗口)调用 publishChannelNotification 接口发布消息,对应频道的所有订阅者,将收到消息,回调函数将被调用,并传入相应的参数.1.5 窗口侧边栏菜单效果(抽屉效果)调用 setSlidingWindow 接口实现侧边栏菜单效果。手势滑动实现侧边栏菜单的打开和关闭功能。相关接口:setSlidingWindowEnabled,toggleSlidingWindo
16、w2、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 应用,在应用执行过程中加载本地网页用。当 dataTyp