AppCan uexWindow.docx

uexwindow 1、簡(jiǎn)介 1.1 window.uexonload 1.2 浮動(dòng)窗口 1.3多窗口之間的通訊 1.4 多窗口通訊之訂閱發(fā)布模式 1.5 窗口側(cè)邊欄菜單效果(抽屜效果) 2、api概覽 2.1、方法 open 打開(kāi)窗口 close 關(guān)閉窗口 forward 前進(jìn)到下一個(gè)頁(yè)面 back 返回上一個(gè)頁(yè)面 pageforward 前進(jìn)到下一個(gè)頁(yè)面 pageback 返回上一個(gè)頁(yè)面 windowforward 前進(jìn)到下一個(gè)窗口 windowback 返回到上一個(gè)窗口 showsoftkeyboard 彈出軟鍵盤(pán) hidesoftkeyboard 關(guān)閉軟鍵盤(pán) alert 彈出alert對(duì)話框 confirm 彈出confirm對(duì)話框 prompt 彈出prompt對(duì)話框 actionsheet 彈出菜單列表 setreportkey 設(shè)置當(dāng)前頁(yè)面是否攔截某個(gè)按鍵 setwindowframe 移動(dòng)當(dāng)前窗口位置 openslibing 打開(kāi)一個(gè)兄弟窗口 closeslibing 關(guān)閉一個(gè)兄弟窗口 showslibing 顯示兄弟窗口 evaluatescript 執(zhí)行js腳本 evaluatepopoverscript 在浮動(dòng)窗口中執(zhí)行js腳本 evaluatemultipopoverscript 在多頁(yè)面浮動(dòng)窗口中執(zhí)行js腳本 setswiperate 設(shè)置左右手勢(shì)的靈敏度 toast 彈出消息提示框 closetoast 關(guān)閉消息提示框 openpopover 打開(kāi)浮動(dòng)窗口 closepopover 關(guān)閉浮動(dòng)窗口 preopenstart 開(kāi)始浮動(dòng)窗口的預(yù)加載 preopenfinish 結(jié)束浮動(dòng)窗口的預(yù)加載 setpopoverframe 更改浮動(dòng)窗口的位置和大小 openmultipopover 打開(kāi)多頁(yè)面浮動(dòng)窗口 closemultipopover 關(guān)閉多頁(yè)面浮動(dòng)窗口 setselectedpopoverinmultiwindow 設(shè)置多頁(yè)面浮動(dòng)窗口跳轉(zhuǎn)到的子頁(yè)面窗口的索引 setmultipopoverframe 更改多頁(yè)面浮動(dòng)窗口的位置和大小 bringtofront 置頂當(dāng)前浮動(dòng)窗口 sendtoback 置底當(dāng)前浮動(dòng)窗口 insertabove 將當(dāng)前浮動(dòng)窗口插入到指定浮動(dòng)窗口之上 insertbelow 將當(dāng)前浮動(dòng)窗口插入到指定浮動(dòng)窗口之下 bringpopovertofront 置頂指定浮動(dòng)窗口 sendpopovertoback 置底指定浮動(dòng)窗口 insertpopoverabovepopover 將指定浮動(dòng)窗口插入到另一浮動(dòng)窗口之上 insertpopoverbelowpopover insertwindowabovewindow 將指定窗口插入到另一窗口之上 insertwindowbelowwindow 將指定窗口插入到另一窗口之下 setwindowhidden 設(shè)置當(dāng)前窗口顯示和隱藏 toggleslidingwindow 打開(kāi)側(cè)滑窗口 setslidingwindow 設(shè)置側(cè)滑窗口 setslidingwindowenabled 設(shè)置側(cè)滑窗口是否可用 setmultilpopoverflippingenbaled 設(shè)置控件是否響應(yīng)滑動(dòng)事件 setorientation 設(shè)置屏幕方向 setwindowscrollbarvisible 設(shè)置滾動(dòng)條的顯示和隱藏 createprogressdialog創(chuàng)建全局對(duì)話框 destroyprogressdialog 銷(xiāo)毀全局對(duì)話框 postglobalnotification 發(fā)送全局消息 subscribechannelnotification 注冊(cè)接收全局消息的監(jiān)聽(tīng)器 publishchannelnotification 發(fā)送全局消息 getstate 獲取當(dāng)前窗口處于前臺(tái)還是后臺(tái) statusbarnotification 發(fā)送消息到狀態(tài)欄 beginanimition 開(kāi)始設(shè)置動(dòng)畫(huà)的相關(guān)參數(shù) setanimitiondelay 設(shè)置動(dòng)畫(huà)延遲執(zhí)行時(shí)間 setanimitionduration 設(shè)置動(dòng)畫(huà)持續(xù)時(shí)間 setanimitioncurve 設(shè)置動(dòng)畫(huà)曲線類(lèi)型 setanimitionrepeatcount 設(shè)置動(dòng)畫(huà)重復(fù)次數(shù) setanimitionautoreverse 設(shè)置動(dòng)畫(huà)結(jié)束后自動(dòng)恢復(fù)位置和狀態(tài) maketranslation 設(shè)置移動(dòng)動(dòng)畫(huà) makescale 設(shè)置伸縮動(dòng)畫(huà) makerotate 設(shè)置旋轉(zhuǎn)動(dòng)畫(huà) makealpha 設(shè)置透明度動(dòng)畫(huà) commitanimition 提交動(dòng)畫(huà)設(shè)置并開(kāi)始執(zhí)行動(dòng)畫(huà) getbounce 獲取網(wǎng)頁(yè)彈動(dòng)狀態(tài) setbounce 設(shè)置是否支持網(wǎng)頁(yè)彈動(dòng) notifybounceevent 注冊(cè)接收彈動(dòng)事件 showbounceview 顯示彈動(dòng)效果 resetbounceview 設(shè)置彈動(dòng)效果結(jié)束后顯示的網(wǎng)頁(yè) setbounceparams 設(shè)置彈動(dòng)參數(shù) hiddenbounceview 隱藏彈動(dòng)效果 geturlquery 獲取加載頁(yè)面時(shí)傳入的參數(shù) setstatusbartitlecolor 設(shè)置狀態(tài)條上字體的顏色 getslidingwindowstate 獲取側(cè)滑窗口顯示情況 setautorotateenable 獲取側(cè)滑窗口顯示情況 setissupportslidecallback 設(shè)置網(wǎng)頁(yè)是否支持滑動(dòng)的相關(guān)監(jiān)聽(tīng)方法 disturblongpressgesture 阻礙當(dāng)前網(wǎng)頁(yè)長(zhǎng)按手勢(shì) setautorotateenable 獲取側(cè)滑窗口顯示情況 sethardwareenable 設(shè)置窗口的硬件加速 setpophardwareenable 設(shè)置popover的硬件加速功能 reload 重載當(dāng)前頁(yè)面 reloadwidgetbyappid 根據(jù)appid重載widget 2.2 回調(diào)方法 cbconfirm 彈出confirm對(duì)話框的回調(diào)方法 cbprompt 彈出prompt對(duì)話框的回調(diào)方法 cbactionsheet 彈出菜單列表的回調(diào)方法 cbgetstate 獲取窗口是否處于前臺(tái)的回調(diào)方法 cbpageback 返回到上一個(gè)頁(yè)面的回調(diào)方法 cbpageforward 前進(jìn)到下一個(gè)頁(yè)面的回調(diào)方法 cbopenmultipopover 打開(kāi)多頁(yè)面浮動(dòng)窗口的回調(diào)方法 cbgeturlquery 獲取參數(shù)時(shí)的回調(diào)方法 cbbouncestate 獲取網(wǎng)頁(yè)彈動(dòng)狀態(tài)的回調(diào)方法 cbslidingwindowstate 獲取側(cè)滑窗口顯示情況的回調(diào)方法 2.3 監(jiān)聽(tīng)方法 uexonload 網(wǎng)頁(yè)加載完成時(shí)的回調(diào)方法 onslipedupward 上滑的監(jiān)聽(tīng)方法，內(nèi)容超過(guò)一屏?xí)r有效 onslipeddownward 下滑的監(jiān)聽(tīng)方法，內(nèi)容超過(guò)一屏?xí)r有效 onslipedupedge 滑到頂部的監(jiān)聽(tīng)方法，內(nèi)容超過(guò)一屏?xí)r有效 onslipeddownedge 滑到底部的監(jiān)聽(tīng)方法，內(nèi)容超過(guò)一屏?xí)r有效 onanimationfinish 動(dòng)畫(huà)執(zhí)行完成的監(jiān)聽(tīng)方法，只對(duì)浮動(dòng)窗口有效 onsetwindowframefinish 當(dāng)前窗口位置移動(dòng)完成的監(jiān)聽(tīng)方法 onswiperight 向右滑動(dòng)的監(jiān)聽(tīng)方法 onswipeleft 向左滑動(dòng)的監(jiān)聽(tīng)方法 onbouncestatechange 彈動(dòng)狀態(tài)改變的監(jiān)聽(tīng)方法 onglobalnotification 全局消息的監(jiān)聽(tīng)方法 onkeypressed 按鍵事件的監(jiān)聽(tīng)方法 onstatechange 窗口前后臺(tái)狀態(tài)變化的監(jiān)聽(tīng)方法 onpopoverloadfinishinrootwnd 浮動(dòng)窗口加載完成的監(jiān)聽(tīng)方法 3 術(shù)語(yǔ)表 windowanimationid 窗口動(dòng)畫(huà)id1、簡(jiǎn)介 窗口對(duì)象。窗口對(duì)象是實(shí)現(xiàn)多窗口機(jī)制的基本單元。使用窗口對(duì)象構(gòu)建hybrid app，在性能方面更加接近native app的體驗(yàn)。appcan平臺(tái)中，維護(hù)了一個(gè)窗口堆棧，每個(gè)窗口以唯一的窗口名字來(lái)區(qū)別。窗口名字是 通過(guò)uexwindow.open來(lái)賦值的。然而有一個(gè)窗口是比較特殊的，即加載起始頁(yè)的窗口，因?yàn)槠鹗柬?yè)是由 config.xml中配置的，無(wú)法進(jìn)行窗口名的賦值，因此，appcan對(duì)加載起始頁(yè)的窗口統(tǒng)一命名為root，也就是說(shuō) ，其它通過(guò)uexwindow.open開(kāi)啟的窗口，不能再命名為root。1.1 window.uexonload 窗口加載完畢后平臺(tái)將觸發(fā)此方法。類(lèi)比window.onload方法，都是html頁(yè)面加載完成 之后觸發(fā)的方法。區(qū)別是，window.uexonload方法會(huì)晚于window.onload方法，原因是window.uexonload需要等 待appcan擴(kuò)展對(duì)象，即uex前綴的對(duì)象初始化完畢。事件加載完成之后，可以安全的使用uex擴(kuò)展對(duì)象。1.2 浮動(dòng)窗口 主窗口之上可以有多個(gè)浮動(dòng)窗口，即浮動(dòng)窗口是附屬于某個(gè)主窗口的。主窗口關(guān)閉后， 其上所有浮動(dòng)窗口也都會(huì)關(guān)閉。所有的窗口都有唯一的名字，通過(guò)uexwindow.open打開(kāi)的是一個(gè)主窗口，浮動(dòng)窗 口則通過(guò)uexwindow.openpopover創(chuàng)建。一個(gè)主窗口上的多個(gè)浮動(dòng)窗口名字是唯一的，但不同主窗口上的浮動(dòng)窗 口名字可以相同。浮動(dòng)窗口可以有彈動(dòng)效果，可以有數(shù)學(xué)變化：放大，旋轉(zhuǎn)，移動(dòng)等。浮動(dòng)窗口能夠解決的事情 很多，比如解決手機(jī)瀏覽器不支持局部div滾動(dòng), 上下拉刷新特效，抽屜特效等問(wèn)題。1.3多窗口之間的通訊窗口之間的通訊，比如從網(wǎng)絡(luò)獲取一個(gè)數(shù)據(jù)，根據(jù)返回的數(shù)據(jù)，讓其它窗口執(zhí)行相應(yīng)的 變化，這就需要用到窗口間通訊機(jī)制。主窗口之間通訊: uexwindow.evaluatescript(winname, type, script)主窗口與浮動(dòng)窗口之間通訊: uexwindow.evaluatescript(winname, type, script); uexwindow.evaluatepopoverscript(winname, type, script); 最后一個(gè)參數(shù)script，是目標(biāo)窗口的執(zhí)行腳本。腳本形參限定為數(shù)字和字符串。如果是 特殊字符和漢字，則無(wú)法傳遞，可以通過(guò)window.localstorage暫存數(shù)據(jù)，在執(zhí)行腳本的目標(biāo)窗口中獲取 localstorage。1.4 多窗口通訊之訂閱發(fā)布模式 調(diào)用接口subscribechannelnotification訂閱一個(gè)頻道，注冊(cè)監(jiān)聽(tīng)函數(shù)。 在任何窗口（包括主窗口，浮動(dòng)窗口，多頁(yè)面浮動(dòng)窗口）調(diào)用publishchannelnotification接口發(fā)布消息，對(duì)應(yīng)頻道的所有訂閱者，將收到消息，回調(diào)函數(shù)將被調(diào)用，并傳入相應(yīng)的參數(shù).1.5 窗口側(cè)邊欄菜單效果(抽屜效果) 調(diào)用setslidingwindow接口實(shí)現(xiàn)側(cè)邊欄菜單效果。手勢(shì)滑動(dòng)實(shí)現(xiàn)側(cè)邊欄菜單的打開(kāi)和關(guān)閉功能。相關(guān)接口：setslidingwindowenabled，toggleslidingwindow2、api概覽2.1、方法open 打開(kāi)窗口uexwindow.open(windname,datatype,data,animid,w,h,flag,animduration,extras)說(shuō)明:打開(kāi)一個(gè)新窗口，如果窗口名字相同，則會(huì)覆蓋相同窗口名字的頁(yè)面內(nèi)容。參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明windnamestring是窗口名字，可為空，不能為”root”，若已經(jīng)打開(kāi)過(guò)該名字的窗口，則直接跳轉(zhuǎn)至該窗口。datatypenumber是窗口載入的數(shù)據(jù)的類(lèi)型，0：url方式載入；1：html內(nèi)容方式載入datastring是url或html數(shù)據(jù)，支持“wgtroot:/” 協(xié)議頭，此協(xié)議頭用于某些將項(xiàng)目部署在服務(wù)器上 的appcan應(yīng)用，在應(yīng)用執(zhí)行過(guò)程中加載本地網(wǎng)頁(yè)用。當(dāng)datatype為0時(shí)，url支持相對(duì)路徑、 絕對(duì)路徑。其中，當(dāng)url以“wgtroot:/” 協(xié)議開(kāi)頭時(shí)，支持從服務(wù)器網(wǎng)頁(yè)中打開(kāi)本地應(yīng)用沙箱中相應(yīng)widget目錄下的網(wǎng)頁(yè)文件。 例如：當(dāng)前窗口加載的是服務(wù)器上的/xxx.html網(wǎng)頁(yè)，如果在xxx.html頁(yè)面中open一個(gè)窗口時(shí)，傳入的data為“wgtroot:/index.html”, 那么本次open執(zhí)行時(shí)，引擎將會(huì)到本應(yīng)用沙箱目錄的widget路徑下去尋找此頁(yè)面， 例如android上找到的路徑會(huì)是：file:/android_assert/widget/index.html 當(dāng)datatype為1時(shí)，把相應(yīng)html的內(nèi)容傳進(jìn)去（不建議）animationidnumber是動(dòng)畫(huà)id，詳見(jiàn)術(shù)語(yǔ)表-windowanimationid 窗口動(dòng)畫(huà)idwnumber是窗口寬度，請(qǐng)傳0hnumber是窗口高度，請(qǐng)傳0flagnumber是窗口標(biāo)記，詳見(jiàn)constant中windowflagsanimdurationnumber否動(dòng)畫(huà)持續(xù)時(shí)長(zhǎng)，單位為毫秒，默認(rèn)為260毫秒extrasstring否擴(kuò)展參數(shù)，設(shè)置值時(shí)，animduration參數(shù)必傳，json格式如下1. var extras = 2. extrainfo:/網(wǎng)頁(yè)配置3. opaque:,/boolean 可選 頁(yè)面是否透明，默認(rèn)false4. bgcolor:,/string 可選 支持圖片和顏色，格式為 #fff、#ffffff、rgba(r,g,b,a)等，圖片路徑支持 res:/ wgt:/ 等appcan協(xié)議路徑5. hardware: /是否開(kāi)啟硬件加速，0：否，1：開(kāi)啟（僅android）6. 7. ,8. animationinfo:/動(dòng)畫(huà)配置,僅ios且animationid選擇bounce類(lèi)的動(dòng)畫(huà)時(shí)有效9. bounciness:,/number,可選，模擬彈性大小系數(shù)，傳0-1之間的double值，越大表示彈性越快10. speed:,/number,可選,模擬震蕩速度系數(shù)，傳0-1之間的double值，越大表示速度越快11. 平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.open(dd, 0, index.html, 1, , , 0, 500);close 關(guān)閉窗口uexwindow.close(animid,animduration)說(shuō)明:關(guān)閉當(dāng)前窗口，若為浮動(dòng)窗口直接關(guān)閉，若為主窗口，則同時(shí)會(huì)關(guān)閉在其上打開(kāi)的所有浮動(dòng)窗口參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明animidnumber否為空時(shí)無(wú)動(dòng)畫(huà)，-1時(shí)代表open時(shí)指定動(dòng)畫(huà)的方向動(dòng)畫(huà)animdurationnumber否動(dòng)畫(huà)持續(xù)時(shí)長(zhǎng)，單位為毫秒，默認(rèn)為260毫秒平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.close(-1, 1000);forward 前進(jìn)到下一個(gè)頁(yè)面uexwindow.forward()說(shuō)明:僅在主窗口起作用，針對(duì)通過(guò)a標(biāo)簽跳轉(zhuǎn)的網(wǎng)頁(yè)，支持加密網(wǎng)頁(yè)。參數(shù):無(wú)平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+back 返回上一個(gè)頁(yè)面uexwindow.back()說(shuō)明:支持加密網(wǎng)頁(yè)的back，僅在主窗口起作用。在手機(jī)的webkit中，存在一個(gè)bug，當(dāng)a.html跳轉(zhuǎn)到b.html,b.html跳轉(zhuǎn)到c.html，那么，用自帶的history.back(),從c返回到b，b再返回的話，會(huì)返回到c，即陷入死循環(huán)。參數(shù):無(wú)平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+pageforward 前進(jìn)到下一個(gè)頁(yè)面uexwindow.pageforward()說(shuō)明:不支持含加密網(wǎng)頁(yè)的forward，支持在主窗口和浮動(dòng)窗口中調(diào)用參數(shù):無(wú)平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+pageback 返回上一個(gè)頁(yè)面uexwindow.pageback()說(shuō)明:不支持含加密網(wǎng)頁(yè)的back，支持在主窗口和浮動(dòng)窗口中調(diào)用。參數(shù):無(wú)平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+windowforward 前進(jìn)到下一個(gè)窗口uexwindow.windowforward(animid,animduration)說(shuō)明:在多窗口機(jī)制中，前進(jìn)到下一個(gè)window。參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明animidnumber否動(dòng)畫(huà)id，詳見(jiàn)constant中windowanimiidanimdurationnumber否動(dòng)畫(huà)持續(xù)時(shí)長(zhǎng)，單位為毫秒，默認(rèn)為260毫秒平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+windowback 返回到上一個(gè)窗口uexwindow.windowback(inanimitionid,inanimduration)說(shuō)明:在多窗口機(jī)制中，用于返回上一個(gè)window，比如在awindow中uexwindow.open了bwindow，那么在bwindow中返回awindow就可使用此方法。參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明inanimitionidnumber否動(dòng)畫(huà)idinanimdurationnumber否動(dòng)畫(huà)持續(xù)時(shí)長(zhǎng)，單位為毫秒，默認(rèn)250毫秒平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+showsoftkeyboard 彈出軟鍵盤(pán)uexwindow.showsoftkeyboard()說(shuō)明:彈出android設(shè)備軟鍵盤(pán)參數(shù):無(wú)平臺(tái)支持：android2.2+版本支持：3.0.0+hidesoftkeyboard 關(guān)閉軟鍵盤(pán)uexwindow. hidesoftkeyboard說(shuō)明:關(guān)閉android設(shè)備軟鍵盤(pán)參數(shù):無(wú)平臺(tái)支持：android2.2+版本支持：3.1.0+alert 彈出alert對(duì)話框uexwindow.alert(title,message,buttonlable)說(shuō)明:彈出只有一個(gè)確定按鈕的對(duì)話框參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明titlestring是標(biāo)題messagestring是內(nèi)容buttonlablestring是顯示在按鈕上的文字平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.alert(提示,alert框測(cè)試,ok);confirm 彈出confirm對(duì)話框uexwindow.confirm(title,message,buttonlable)說(shuō)明:彈出至少包含一個(gè)至多包含3個(gè)按鈕的對(duì)話框參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明titlestring是標(biāo)題messagestring是內(nèi)容buttonlablearray是顯示在按鈕上的文字的集合平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.confirm(警告,確定退出么？,ok,cancel);prompt 彈出prompt對(duì)話框uexwmpt(title,message,defaultvalue,buttonlable)說(shuō)明:彈出包含兩個(gè)按鈕且?guī)л斎肟虻膶?duì)話框參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明titlestring是標(biāo)題messagestring是內(nèi)容defaultvaluestring是輸入框默認(rèn)文字buttonlablearray是顯示在按鈕上的文字的集合平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwmpt(提示,請(qǐng)輸入內(nèi)容：,ok,cancel);actionsheet 彈出菜單列表uexwindow.actionsheet(title,cancel,buttonlables)說(shuō)明:從界面底部彈出按鈕列表, 其回調(diào)接口是cbactionsheet參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明titlestring是標(biāo)題cancelstring是顯示在取消按鈕上的文本buttonlablearray是按鈕列表文字平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.actionsheet(菜單,cancel,opt1,opt2,opt3,opt4,opt5,opt6);setreportkey 設(shè)置當(dāng)前頁(yè)面是否攔截某個(gè)按鍵uexwindow.setreportkey(keycode,enable)說(shuō)明:設(shè)置當(dāng)前頁(yè)面是否攔截某個(gè)按鍵參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明keycodenumber是要攔截的鍵值,0-返回鍵，1-菜單鍵enablenumber是是否攔截,0-不攔截，1-攔截平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.setreportkey(1,1)setwindowframe 移動(dòng)當(dāng)前窗口位置uexwindow.setwindowframe(x,y,animduration)說(shuō)明:移動(dòng)當(dāng)前window相對(duì)屏幕的位置參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明xnumber是x坐標(biāo)ynumber是y坐標(biāo)animdurationnumber否動(dòng)畫(huà)持續(xù)時(shí)長(zhǎng)，單位為毫秒，默認(rèn)為260毫秒平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.setwindowframe(200,200,1000)openslibing 打開(kāi)一個(gè)兄弟窗口uexwindow.openslibing(type,datatype,url,data,w,h)說(shuō)明:打開(kāi)一個(gè)兄弟窗口參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明typenumber是窗口的類(lèi)型，1-頭部；2-底部datatype(string是窗口載入的數(shù)據(jù)的類(lèi)型，0：url方式載入；1：html內(nèi)容方式載入； 2：既有url方式，又有html內(nèi)容方式urlnumber是窗口路徑datastring是數(shù)據(jù)，可為空wnumber是該參數(shù)無(wú)效，實(shí)際寬度為屏幕寬度，請(qǐng)傳”hnumber是窗口高度，支持百分?jǐn)?shù)，默認(rèn)為屏幕高度平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.openslibing(1, 0, nav.html, , , 75);closeslibing 關(guān)閉一個(gè)兄弟窗口uexwindow.closeslibing(type)說(shuō)明:關(guān)閉一個(gè)兄弟窗口參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明typenumber是窗口的類(lèi)型，1-頭部；2-底部平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.closeslibing(2);showslibing 顯示兄弟窗口uexwindow.showslibing(type)說(shuō)明:顯示open過(guò)的兄弟窗口參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明typenumber是窗口的類(lèi)型，1-頭部；2-底部平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.showslibing(1)evaluatescript 執(zhí)行js腳本uexwindow.evaluatescript(windname,type,js)說(shuō)明:執(zhí)行js腳本參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明windnamestring是窗口名稱(chēng)，默認(rèn)空為當(dāng)前窗口（可以是主窗口、root窗口、浮動(dòng)窗口）typenumber是窗口的類(lèi)型，uex.cwindowtypenormal，uex.cwindowtypetop 或uex.cwindowtypebottom，詳見(jiàn)constant中windowtypesjsstring是js腳本內(nèi)容平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.evaluatescript(, 0, alert(執(zhí)行去吧！););evaluatepopoverscript 在浮動(dòng)窗口中執(zhí)行js腳本uexwindow.evaluatepopoverscript(windname,popname,js)說(shuō)明:在浮動(dòng)窗口中執(zhí)行js腳本參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明windnamestring是窗口名稱(chēng)，默認(rèn)空為當(dāng)前窗口（只能為主窗口、root窗口）popnamestring是浮動(dòng)窗口名稱(chēng)jsstring是js腳本內(nèi)容平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.evaluatepopoverscript(, sss, alert(執(zhí)行去吧！););evaluatemultipopoverscript 在多頁(yè)面浮動(dòng)窗口中執(zhí)行js腳本uexwindow.evaluatemultipopoverscript(windname,popname,inpagename,js)說(shuō)明:在多頁(yè)面浮動(dòng)窗口中執(zhí)行js腳本參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明windnamestring是窗口名稱(chēng)，默認(rèn)為當(dāng)前窗口popnamestring是浮動(dòng)窗口名稱(chēng)inpagenamestring是單頁(yè)面窗口的名字jsstring是js腳本內(nèi)容平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.evaluatemultipopoverscript(, multipop, pop2, alert(multipop);setswiperate 設(shè)置左右手勢(shì)的靈敏度uexwindow.setswiperate(rate)說(shuō)明:設(shè)置左右手勢(shì)的靈敏度參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明ratenumber是靈敏度，大于等于1平臺(tái)支持：android2.2+版本支持：3.0.0+toast 彈出消息提示框uexwindow.toast(type,location,msg,duration)說(shuō)明:彈出消息提示框，常見(jiàn)的用于獲取網(wǎng)絡(luò)數(shù)據(jù)，在請(qǐng)求過(guò)程中給個(gè)加載提示，數(shù)據(jù)加載完成時(shí)關(guān)閉提示。參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明typenumber是0-沒(méi)有進(jìn)度條；1-有進(jìn)度條locationnumber是顯示位置，詳見(jiàn)constant中windowtoastlocationmsgnumber是消息durationnumber是顯示時(shí)間，非正整數(shù)時(shí)，提示框一直存在，不會(huì)自動(dòng)關(guān)閉平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.toast(1,5,正在加載.,0);closetoast 關(guān)閉消息提示框uexwindow.closetoast()說(shuō)明:關(guān)閉消息提示框參數(shù):無(wú)平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.closetoast()openpopover 打開(kāi)浮動(dòng)窗口uexwindow.openpopover(popname,datatype,url,data,x,y,w,h,fontsize,flag,bottommargin,extrainfo)說(shuō)明:打開(kāi)浮動(dòng)窗口，如果浮動(dòng)窗口名字相同，則會(huì)覆蓋相同浮動(dòng)窗口名字的頁(yè)面內(nèi)容。參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明popnamestring是名稱(chēng)datatypenumber是窗口載入的數(shù)據(jù)的類(lèi)型，0：url方式載入；1：html內(nèi)容方式載入；2：既有url方式， 又有html內(nèi)容方式urlstring是url類(lèi)型數(shù)據(jù)，支持“wgtroot:/” 協(xié)議頭，此協(xié)議頭用于某些將項(xiàng)目部署在服務(wù)器上的appcan應(yīng)用，在應(yīng)用執(zhí)行過(guò)程中 加載本地網(wǎng)頁(yè)用。當(dāng)datatype為0時(shí)，url支持相對(duì)路徑、絕對(duì)路徑。其中，當(dāng)url以“wgtroot:/” 協(xié)議開(kāi)頭時(shí)，支持從服務(wù)器網(wǎng)頁(yè)中打開(kāi)本地應(yīng)用沙箱中相應(yīng)widget目錄下的網(wǎng)頁(yè)文件。 例如：當(dāng)前窗口加載的是服務(wù)器上的/xxx.html網(wǎng)頁(yè)，如果在xxx.html頁(yè)面中open一個(gè)窗口時(shí)，傳入的data為“wgtroot:/index.html” , 那么本次open執(zhí)行時(shí)，引擎將會(huì)到本應(yīng)用沙箱目錄的widget路徑下去尋找此頁(yè)面， 例如android上找到的路徑會(huì)是：file:/android_assert/widget/index.html 。datastring是data類(lèi)型數(shù)據(jù)xnumber是x坐標(biāo)ynumber是y坐標(biāo)wnumber是寬度，為空時(shí)默認(rèn)為window的寬度hnumber是高度，為空時(shí)默認(rèn)為window的高度f(wàn)ontsizenumber是字體大小flagnumber是浮動(dòng)窗口標(biāo)記，詳見(jiàn)constant中windowflagsbottommarginnumber否浮動(dòng)窗口相對(duì)父窗口底部的距離。當(dāng)值不等于0時(shí)，h參數(shù)無(wú)效。extrainfostring否設(shè)置值時(shí)，bottommargin參數(shù)必傳，json格式如下： “extrainfo”:“opaque”:”true”,”bgcolor”:”#011”,”delaytime”:”250”關(guān)于extrainfo中字段的說(shuō)明如下：參數(shù)是否必須說(shuō)明extrainfo必選extrainfo參數(shù)opaque可選是否透明true/false默認(rèn)為falsebgcolor可選背景色，支持圖片和顏色，格式為#fff、#ffffff、rgba(r,g,b,a)等，圖片路徑支持res:/、 wgt:/等appcan協(xié)議路徑delaytime可選延遲打開(kāi)窗口，單位為毫秒，避免父窗口在uexonload中打開(kāi)浮動(dòng)窗口產(chǎn)生卡頓。 設(shè)置值時(shí)，bottommargin參數(shù)必傳hardware可選是否開(kāi)啟硬件加速，0:關(guān)閉，1:開(kāi)啟（僅android）平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.openpopover(sss,0,hidden.html,400,0,0,100);closepopover 關(guān)閉浮動(dòng)窗口uexwindow.closepopover(popname)說(shuō)明:關(guān)閉浮動(dòng)窗口參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明popnamestring是名稱(chēng)平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.closepopover(sss)preopenstart 開(kāi)始浮動(dòng)窗口的預(yù)加載uexwindow.preopenstart()說(shuō)明:popover的預(yù)加載必須要與uexwindow.open中的flag：uex.cwiondowflagpreopen=64配合使用，即open時(shí)有此flag方可對(duì)應(yīng)使用預(yù)加載。開(kāi)始popover(浮動(dòng)窗口)的預(yù)加載。即一個(gè)窗口中需要有多個(gè)浮動(dòng)窗口，可以讓這些浮動(dòng)窗口預(yù)先加載出來(lái)。其執(zhí)行過(guò)程：a窗口打開(kāi)b窗口，b窗口中需要預(yù)加載多個(gè)浮動(dòng)窗口。那么a窗口中執(zhí)行uexwindow.open時(shí)，其flag參數(shù)需要：uex.cwiondowflagpreopenreopen=64配合使用，即open時(shí)有此flag，b窗口方可使用預(yù)加載。此時(shí)在b窗口中，會(huì)等所有預(yù)加載的浮動(dòng)窗口都加載完畢（不包括異步獲取網(wǎng)絡(luò)數(shù)據(jù)），方才顯示b窗口。預(yù)加載的浮動(dòng)窗口的開(kāi)啟函數(shù)，即uexwindow.openpopover，需要放置于uexwindow.preopenstart和uexwindow.preopenfinish之間。參數(shù):無(wú)平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:在a窗口中，首先open窗口b，在b窗口中，預(yù)加載多個(gè)浮動(dòng)窗口：a.html1. 2. 3. 4. appcan api uexwindow a5. 6. 7. window.uexonload = function(type)8. if(!type)9. uexwindow.open(b,0,b.html,0,64);10. 11. 12. 13. 14. 15. 16. b.html1. 2. 3. 4. appcan api uexwindow b5. 6. 7. 8. 9. 10. window.uexonload = function(type)11. if(!type)12. var s = window.getcomputedstyle($(content), null);13. uexwindow.preopenstart(); uexwindow.openpopover(b1,0,b1.html,0,int($14.15. $(header).offsetheight),int(s.width),int(s.height),int(s.fontsize),0);16. uexwindow.openpopover(b2,0,b2.html,0,int($(header).offsetheight),int(s.width),int17.18. (s.height),int(s.fontsize),0);19. uexwindow.preopenfinish();20. 21. 22. 23. preopenfinish 結(jié)束浮動(dòng)窗口的預(yù)加載uexwindow.preopenfinish()說(shuō)明:結(jié)束浮動(dòng)窗口的預(yù)加載參數(shù):無(wú)平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.preopenfinish()setpopoverframe 更改浮動(dòng)窗口的位置和大小uexwindow.setpopoverframe(popname,x,y,w,h)說(shuō)明:更改浮動(dòng)窗口的位置和大小參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明popnamestring是名稱(chēng)xnumber是x坐標(biāo)ynumber是y坐標(biāo)wnumber是寬度，為空時(shí)默認(rèn)為window的寬度hnumber是高度，為空時(shí)默認(rèn)為window的高度平臺(tái)支持：android2.2+ios6.0+版本支持：3.0.0+示例:1. uexwindow.setpopoverframe(sss,500,200,400,400);openmultipopover 打開(kāi)多頁(yè)面浮動(dòng)窗口uexwindow.openmultipopover(content,popname,datatype,x,y,w,h,fontsize,flag,indexselected,extrainfo)說(shuō)明:在當(dāng)前window打開(kāi)一個(gè)多頁(yè)面浮動(dòng)窗口,頁(yè)面之間滑動(dòng)切換參數(shù):參數(shù)名稱(chēng)參數(shù)類(lèi)型是否必選說(shuō)明contentstring是多頁(yè)面窗口數(shù)據(jù)格式為json。不可為空。 json格式如下： “content”:“inpagename”:”p1”,”inurl”:”xxx1.html”,”indata”:”, “extrainfo”:“opaque”:”true”,”bgcolor”:”#011”, “inpagename”:”p2”,”inurl”:”xxx2.html”,”indata”:”, “extrainfo”:“opaque”:”true”,”bgcolor”:”#011”popnamestring是浮動(dòng)窗口名稱(chēng)datatypenumber是窗口載入的數(shù)據(jù)的類(lèi)型，0：url方式載入；1：html內(nèi)容方式載入；2：既有url方式， 又有html內(nèi)容方式xnumber是x坐標(biāo)ynumber是y坐標(biāo)wnumber是寬度，為空時(shí)默認(rèn)為window的寬度hnumber是高度，為空時(shí)默認(rèn)為window的高度f(wàn)ontsizenumber是字體大小flagnumber是浮動(dòng)窗口標(biāo)記，詳見(jiàn)constant中windowflagsindexselectednumber是默認(rèn)打開(kāi)的頁(yè)面索引，默認(rèn)為0extrainfostring否擴(kuò)展參數(shù)，json格式如下：“extrainfo”:“opaque”:”true”,”bgcolor”:”#011”, “delaytime”:”250”content json中各字段的說(shuō)明：參數(shù)是否必