打開window
若window已存在,則會(huì)把該window顯示到最前面,同時(shí)若url有變化或者reload參數(shù)為true時(shí),頁面會(huì)重新加載。
openWin({params})
params
name:
- 類型:字符串
- 默認(rèn)值:無
- 描述:window名字
url:
- 類型:字符串
- 默認(rèn)值:無
- 描述:頁面地址,可以為本地文件路徑,支持相對(duì)路徑和絕對(duì)路徑,以及 widget://、fs://等協(xié)議路徑,也可以為遠(yuǎn)程地址。 當(dāng)data參數(shù)不為空時(shí),url將做為baseUrl,data中的html引用的資源文件根路徑以該url為基礎(chǔ)。
data:
- 類型:字符串
- 默認(rèn)值:無
- 描述:(可選項(xiàng))頁面加載的數(shù)據(jù)內(nèi)容,可以為html片段或者整張html文件的數(shù)據(jù)
headers:
- 類型:JSON 對(duì)象
- 默認(rèn)值:無
- 描述:(可選項(xiàng))請(qǐng)求頭
singleInstance:
- 類型:布爾
- 默認(rèn)值:false
- 描述:(可選項(xiàng))設(shè)置該window是否為單例對(duì)象。若設(shè)置為單例對(duì)象,當(dāng)調(diào)用closeWin方法關(guān)閉時(shí),window將只是從屏幕移除而不會(huì)被銷毀,下次再打開時(shí)將直接使用已存在的window,而不會(huì)再重新創(chuàng)建。
avm:
- 類型:布爾
- 默認(rèn)值:若在config.xml里面配置了avm字段,則默認(rèn)值為配置的值,否則為false
- 描述:(可選項(xiàng))是否使用原生引擎來加載頁面,頁面必須是使用avm框架語法生成。
useWKWebView:
- 類型:布爾
- 默認(rèn)值:false
- 描述:(可選項(xiàng))是否使用WKWebView來加載頁面。參考WKWebView介紹。
allowAccessFromFile:
- 類型:布爾
- 默認(rèn)值:全局加密下為false
- 描述:(可選項(xiàng))設(shè)置是否可以在本地頁面中訪問本地或遠(yuǎn)程資源,為保證代碼安全,在開啟全局加密情況下默認(rèn)禁止訪問。只在useWKWebView參數(shù)為true時(shí)有效。
historyGestureEnabled:
- 類型:布爾
- 默認(rèn)值:false
- 描述:(可選項(xiàng))是否可以通過手勢(shì)來進(jìn)行歷史記錄前進(jìn)后退,只在useWKWebView參數(shù)為true時(shí)有效。
syncCookie:
- 類型:布爾
- 默認(rèn)值:true
- 描述:(可選項(xiàng))是否自動(dòng)同步WKWebView外部如ajax產(chǎn)生的Cookie到WKWebView中,只在useWKWebView參數(shù)為true時(shí)有效。
pageParam:
- 類型:JSON 對(duì)象
- 默認(rèn)值:無
- 描述:(可選項(xiàng))頁面參數(shù),新頁面中可以通過 api.pageParam 獲取
bounces:
- 類型:布爾
- 默認(rèn)值:若在 config.xml 里面配置了pageBounce,則默認(rèn)值為配置的值,否則為 false
- 描述:(可選項(xiàng))頁面是否彈動(dòng)。注意如果頁面使用了上拉、下拉刷新等功能,該屬性可能會(huì)被刷新組件重新設(shè)置。
bgColor:
- 類型:字符串
- 默認(rèn)值:若在 config.xml 里面配置了 windowBackground,則默認(rèn)值為配置的值,否則透明
- 描述:(可選項(xiàng))背景色,支持圖片和顏色,格式為 #fff、#ffffff、rgba(r,g,b,a)等,圖片路徑支持 fs://、widget://等 APICloud 自定義文件路徑協(xié)議,同時(shí)支持相對(duì)路徑
scrollToTop:
- 類型:布爾
- 默認(rèn)值:false
- 描述:(可選項(xiàng))當(dāng)點(diǎn)擊狀態(tài)欄,頁面是否滾動(dòng)到頂部。若當(dāng)前屏幕上不止一個(gè)頁面的 scrollToTop 屬性為 true,則所有的都不會(huì)起作用。只 iOS 有效
scrollEnabled:
- 類型:布爾
- 默認(rèn)值:true
- 描述:(可選項(xiàng))頁面內(nèi)容超出后是否可以滾動(dòng),只支持iOS
vScrollBarEnabled:
- 類型:布爾
- 默認(rèn)值:true
- 描述:(可選項(xiàng))是否顯示垂直滾動(dòng)條
hScrollBarEnabled:
- 類型:布爾
- 默認(rèn)值:true
- 描述:(可選項(xiàng))是否顯示水平滾動(dòng)條
scaleEnabled:
- 類型:布爾
- 默認(rèn)值:false
- 描述:(可選項(xiàng))頁面是否可以縮放
hideTopBar:
- 類型:布爾
- 默認(rèn)值:無
- 描述:(可選項(xiàng))是否隱藏原生navigationBar控件,該字段只 iOS 有效
hideBottomBar:
- 類型:布爾
- 默認(rèn)值:無
- 描述:(可選項(xiàng))是否隱藏原生tabBar控件,該字段只 iOS 有效
slidBackEnabled:
- 類型:布爾
- 默認(rèn)值:true
- 描述:(可選項(xiàng))是否支持滑動(dòng)返回。iOS7.0及以上系統(tǒng)中,在新打開的頁面中向右滑動(dòng),可以返回到上一個(gè)頁面,該字段只 iOS 有效
slidBackType:
- 類型:字符串
- 默認(rèn)值:full
- 描述:(可選項(xiàng))當(dāng)支持滑動(dòng)返回時(shí),設(shè)置手指在頁面右滑的有效作用區(qū)域。取值范圍(full:整個(gè)頁面范圍都可以右滑返回,edge:在頁面左邊緣右滑才可以返回),該字段只iOS有效
animation:
- 類型:JSON 對(duì)象
- 默認(rèn)值:無
- 描述:(可選項(xiàng))動(dòng)畫參數(shù),不傳時(shí)使用默認(rèn)動(dòng)畫
- 內(nèi)部字段:
{
type:"none", //動(dòng)畫類型(詳見動(dòng)畫類型常量)
subType:"from_right", //動(dòng)畫子類型(詳見動(dòng)畫子類型常量)
duration:300 //動(dòng)畫過渡時(shí)間,默認(rèn)300毫秒
}
type 取值范圍:
none //無動(dòng)畫效果
push //新視圖將舊視圖推開
movein //新視圖移到舊視圖上面
fade //交叉淡化過渡(不支持過渡方向)
flip //翻轉(zhuǎn)效果
reveal //將舊視圖移開,顯示下面的新視圖
ripple //滴水效果(不支持過渡方向)
curl //向上翻一頁
un_curl //向下翻一頁
suck //收縮效果(不支持過渡方向)
cube //立方體翻滾效果
subType 取值范圍:
from_right //從右邊開始動(dòng)畫
from_left //從左邊開始動(dòng)畫
from_top //從頂部開始動(dòng)畫
from_bottom //從底部開始動(dòng)畫
(Android系統(tǒng)flip,ripple,curl,un_curl,suck,cube 類型不支持)
progress:
- 類型:JSON 對(duì)象
- 默認(rèn)值:無
- 描述:(可選項(xiàng))頁面加載進(jìn)度配置信息,若不傳則無加載進(jìn)度效果
- 內(nèi)部字段:
{
type: //加載進(jìn)度效果類型,默認(rèn)值為 default,取值范圍為 default|page,為 page 時(shí),進(jìn)度效果為仿瀏覽器類型,固定在頁面的頂部
title: //type 為 default 時(shí)顯示的加載框標(biāo)題,字符串類型
text: //type 為 default 時(shí)顯示的加載框內(nèi)容,字符串類型
color: //type 為 page 時(shí)進(jìn)度條的顏色,默認(rèn)值為 #45C01A,支持#FFF,#FFFFFF,rgb(255,255,255),rgba(255,255,255,1.0)等格式
height: //type 為 page 時(shí)進(jìn)度條高度,默認(rèn)值為3,數(shù)字類型
}
delay:
- 類型:數(shù)字
- 默認(rèn)值:0
- 描述:(可選項(xiàng))window 顯示延遲時(shí)間,適用于將被打開的 window 中可能需要打開有耗時(shí)操作的模塊時(shí),可延遲 window 展示到屏幕的時(shí)間,保持 UI 的整體性
reload:
- 類型:布爾
- 默認(rèn)值:false
- 描述:(可選項(xiàng))頁面已經(jīng)打開時(shí),是否重新加載頁面,重新加載頁面后 apiready 方法將會(huì)被執(zhí)行
allowEdit:
- 類型:布爾
- 默認(rèn)值:false
- 描述:(可選項(xiàng))是否允許長(zhǎng)按頁面時(shí)彈出選擇菜單
softInputMode:
- 類型:字符串
- 默認(rèn)值:auto
- 描述:(可選項(xiàng))當(dāng)鍵盤彈出時(shí),輸入框被蓋住時(shí),當(dāng)前頁面的調(diào)整方式,只iOS有效,Android請(qǐng)?jiān)?config.xml 里面配置并云編譯使用
- 取值范圍:
resize //若鍵盤蓋住輸入框,頁面會(huì)自動(dòng)上移
pan //若鍵盤蓋住輸入框,頁面不會(huì)自動(dòng)上移
auto //默認(rèn)值,由系統(tǒng)決定如何處理,iOS平臺(tái)該字段等同于resize
softInputDismissMode:
- 類型:字符串?dāng)?shù)組
- 默認(rèn)值:['tap']
- 描述:(可選項(xiàng))收起鍵盤的方式,只iOS有效。
- 取值范圍:
tap //點(diǎn)擊頁面收起鍵盤,可以和drag或interactive同時(shí)使用
drag //拖拽頁面時(shí)收起鍵盤,可以和tap同時(shí)使用
interactive //在鍵盤和頁面交界處上下滑動(dòng)收起鍵盤,可以和tap同時(shí)使用
softInputBarEnabled:
- 類型:布爾
- 默認(rèn)值:true
- 描述:(可選項(xiàng))是否顯示鍵盤上方的工具條。只支持iOS
overScrollMode:
- 類型:字符串
- 默認(rèn)值:never
- 描述:(可選項(xiàng))設(shè)置頁面滾動(dòng)到頭部或尾部時(shí),顯示回彈陰影效果的模式,僅Android有效。
- 取值范圍:
never //永遠(yuǎn)不顯示
always //總是顯示
scrolls //只有當(dāng)頁面內(nèi)容超出設(shè)備屏幕大小,發(fā)生滾動(dòng)行為時(shí)顯示,建議設(shè)置為該模式。
dragAndDrop:
- 類型:布爾
- 默認(rèn)值:false
- 描述:(可選項(xiàng))是否允許iOS 11及以上系統(tǒng)中頁面元素默認(rèn)的拖拽行為。只支持iOS
hideHomeIndicator:
- 類型:布爾
- 默認(rèn)值:false
- 描述:(可選項(xiàng))是否隱藏虛擬home鍵。設(shè)置為true時(shí),虛擬home鍵會(huì)在屏幕沒有觸摸操作時(shí)自動(dòng)隱藏,觸摸后又會(huì)顯示出來。只支持iOS
defaultRefreshHeader:
- 類型:字符串
- 默認(rèn)值:pull
- 描述:(可選項(xiàng))設(shè)置使用默認(rèn)下拉刷新類型,取值范圍:pull、swipe
customRefreshHeader:
- 類型:字符串
- 默認(rèn)值:無
- 描述:(可選項(xiàng))設(shè)置使用自定義下拉刷新模塊的名稱,設(shè)置后可以使用 api.setCustomRefreshHeaderInfo 方法來使用自定義下拉刷新組件
示例代碼
api.openWin({
name: 'page1',
url: './page1.html',
pageParam: {
name: 'test'
}
});
補(bǔ)充說明
窗口操作
可用性
iOS系統(tǒng),Android系統(tǒng)
可提供的1.0.0及更高版本
更多建議: