openWin

2022-06-13 10:26 更新

打開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及更高版本

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)