The appearance and behavior of the HTML5 container runtime are controlled by a set of parameters. You can specify these parameters when you start a new instance or use `pushWindow`. For example:
mpaas://platformapi/startapp?appId=20000067&url=http%3A%2F%2Fm.taobao.com&showOptionMenu=NO&startMultApp=YESOpen a new HTML5 instance from the frontend
The first URL can also include the __webview_options__ magic parameter. The container extracts the content of this parameter and passes it to the container.
?__webview_options__=showOptionMenu%3DNO&startMultApp%3DYES
urlencode('showOptionMenu=NO&startMultApp=YES') => showOptionMenu%3DNO&startMultApp%3DYESOpen a new HTML5 instance from the client
Set the startup parameters as follows.
Bundle bundle = new Bundle();
bundle.putString("showOptionMenu", "NO");
MPNebula.startUrl(url,bundle);The frontend can retrieve startup parameters that are passed from the client using AlipayJSBridge.startupParams or jsapi:getStartupParams.
Name | Abbreviation | Type | Description | Default value | The pushWindow is active. |
url | String | The starting URL. | "" | Y | |
defaultTitle | dt | String | The default title. This title appears on the title bar before the page loads for the first time. | "" | Y |
showLoading | sl | String | YES/NO. Specifies whether to display a global loading spinner before the page loads. | "NO" | Y |
readTitle | rt | String | YES/NO. Specifies whether to read the webpage title and display it on the title bar. | "YES" | Y |
bizScenario | bz | String | The business scenario source. This value is recorded in every instrumentation point and can be used to distinguish between different sources. | "" | - |
backBehavior | bb | String | `back`, `pop`, or `auto`. Specifies the behavior of the back button. back: Goes back to the previous page if a browser history exists. Otherwise, closes the current WebView. pop: Closes the current window. auto: On iOS, this is equivalent to `pop`. On Android, this is equivalent to `back` when the toolbar is visible, and `pop` when the toolbar is not visible. | For the general browser mode of non-HTML5Apps (appId is 20000067), the default is `back`. For HTML5Apps (started with `startApp`), the default is `pop`. | - |
pullRefresh | pr | String | YES/NO. Specifies whether to support pull-to-refresh. Only local files can be set to YES. | "NO" | Y |
showProgress | sp | bool | YES/NO. Specifies whether to display the loading progress bar. | "NO" | - |
canPullDown | pd | String | YES/NO. Specifies whether the page can be pulled down to show a black background or the domain name. Only local files can be set to NO. | "YES" | Yes |
showDomain | sd | bool | YES/NO. Specifies whether to display the domain name when the page is pulled down. Only local files can be set to NO. For offline packages, this parameter is forced to NO. | "YES" | - |
backgroundColor | bc | int | Sets the background color (decimal, for example: `bc=16775138`). | "" | - |
showOptionMenu | so | bool | YES/NO. Specifies whether to display the "..." button in the upper-right corner. | For HTML5Apps, the default is NO. For non-HTML5Apps, the default is YES. | |
showTitleLoading | tl | bool | YES/NO. Specifies whether to display a small loading spinner to the left of the title in the title bar. | NO | Y |
enableScrollBar | es | bool | YES/NO. Specifies whether to use the WebView scroll bars, including vertical and horizontal. This parameter is for Android only. | The default value is YES. | - |