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” | - |