全部產品
Search
文件中心

Mobile Platform as a Service:啟動參數

更新時間:Jul 23, 2024

H5 容器運行時的外觀和行為受一組參數控制,可在啟動一個新執行個體或者 pushWindow 時指定,例如:

mpaas://platformapi/startapp?appId=20000067&url=http%3A%2F%2Fm.taobao.com&showOptionMenu=NO&startMultApp=YES

從前端開啟一個新的 H5 執行個體

第一個 URL 也可以帶一個魔法參數 __webview_options__,其內容將被容器取出並傳給容器本身。

?__webview_options__=showOptionMenu%3DNO&startMultApp%3DYES
urlencode('showOptionMenu=NO&startMultApp=YES') => showOptionMenu%3DNO&startMultApp%3DYES

從用戶端開啟一個新的 H5 執行個體

啟動參數的設定方法如下。

 Bundle bundle = new Bundle();
 bundle.putString("showOptionMenu", "NO");
 MPNebula.startUrl(url,bundle);

用戶端透傳給前端的啟動參數,前端可以直接通過 AlipayJSBridge.startupParamsjsapi:getStartupParams 擷取。

名稱

縮寫

類型

說明

預設值

pushWindow 可用

url

String

起始 URL

“”

Y

defaultTitle

dt

String

預設標題,在頁面第一次載入之前顯示在標題列上。

“”

Y

showLoading

sl

String

YES/NO,是否在頁面載入前顯示全域菊花。

“NO”

Y

readTitle

rt

String

YES/NO,是否讀取網頁標題顯示在 titleBar 上。

“YES”

Y

bizScenario

bz

String

業務情境來源,這個值會記錄到每一個埋點中,可以用來區分不同來源。

“”

-

backBehavior

bb

String

back,pop,auto 指定後退按鈕行為。

back:如存在瀏覽器歷史則後退到上一頁,否則關閉當前 WebView。

pop:直接關閉當前視窗。

auto:在 iOS 上相當於 pop;在 Android 上,toolbar 可見時相當於 back,toolbar 不可見時相當於 pop。

非 H5App 的通用瀏覽器模式(appId 為 20000067)為 back,H5App(用 startApp 來啟動)為 pop

-

pullRefresh

pr

String

YES/NO,是否支援下拉重新整理。只有本地檔案允許設定為 YES。

“NO”

Y

showProgress

sp

bool

YES/NO,是否顯示載入的進度條。

“NO”

-

canPullDown

pd

String

YES/NO,頁面是否支援下拉(顯示出黑色背景或者網域名稱)。只有本地檔案允許設定為 NO。

“YES”

YES

showDomain

sd

bool

YES/NO,頁面下拉時是否顯示網域名稱。只有本地檔案允許設定為 NO,離線包強制設定為 NO,不允許顯示。

“YES”

-

backgroundColor

bc

int

設定背景顏色(十進位,例如:bc=16775138)。

“”

-

showOptionMenu

so

bool

YES/NO,是否顯示右上方的“…”按鈕。

對於 H5App 為 NO 對於非 H5App 為 YES

showTitleLoading

tl

bool

YES/NO,是否在 TitleBar 的標題左邊顯示小菊花。)

NO

Y

enableScrollBar

es

bool

YES/NO,是否使用 WebView 的捲軸,包括垂直和水平。只對 Android 有效 。

預設為 ”YES”

-