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.startupParams
或 jsapi: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” | - |