Class “WebView”

Object > NativeObject > Widget > WebView

A widget that can display a web page. Since this widget requires a lot of resources it’s recommended to have no more than one instance at a time.

Constructor	public
Singleton	No
Namespace	`tabris`
Direct subclasses	None
JSX support	Element: `<WebView/>` Parent element: `<Composite/>` and any widget extending `Composite` Child elements: None Text content: Not supported

Example

import {WebView, contentView} from 'tabris';

new WebView({
  left: 0, right: 0, top: 0, bottom: 0,
  url: "https://tabris.com"
}).appendTo(contentView);

Constructor

new WebView(properties?)

Parameter	Type	Optional	Description
properties	`Properties<WebView>`	Yes	Sets all key-value pairs in the properties object as widget properties.

Methods

goBack()

Navigate the WebView to the previous page if possible.

Returns void

goForward()

Navigate the WebView to the next page if possible.

Returns void

postMessage(message, targetOrigin)

Posts a web message to the underlying window object of the WebView. The website in the WebView can register for the message in the following fashion: window.addEventListener('message', callbackFunction). For more information see Window.postMessage() API.

Parameter	Type	Optional	Description
message	`string`	No	The message to send. Supports only strings.
targetOrigin	`string`	No	The URL of the page that receives the message. The message is only sent if the current document URL has the same scheme, domain and path. Use `*` to send to any URL.

Returns this

Properties

canGoBack

Whether there is a previous to navigated to via goBack().

Type	`boolean`
Settable	No
Change events	Yes

canGoForward

Whether there is a next page to navigate to via goForward().

Type	`boolean`
Settable	No
Change events	Yes

html

A complete HTML document to display. Always returns the last set value. Note: htmlChanged event will not be fired on iOS when a page is using history.pushState() to navigate between pages.

Type	`string`
Settable	Yes
Change events	Yes

initScript

JavaScript code to be executed before page begins loading.

Type	`string`
Settable	On creation
Change events	No

This property can only be set via constructor or JSX. Once set, it cannot change anymore.

url

The URL of the web page to display. Relative URLs are resolved relative to ‘package.json’. Returns empty string when content from html property is displayed. Note: urlChanged event will not be fired on iOS when a page is using history.pushState() to navigate between pages.

Type	`string`
Settable	Yes
Change events	Yes

Events

navigate

Fired when the WebView is about to navigate to a new URL. Note: This event will not be fired on iOS when a page is using history.pushState() to navigate between pages.

Parameter	Type	Description
preventDefault	`() => void`	Call to intercept the navigation. Not possible when the event is only an anchor navigation
url	`string`	The new URL the WebView is about to navigate to.

load

Fired when the url has been loaded. Note: This event will not be fired on iOS when a page is using history.pushState() to navigate between pages.

download

Android

Fired when the WebView requests a download. The download event provides the properties url, mimeType, contentLength and contentDisposition. Supported only on Android.

Parameter	Type	Description
contentDisposition	`string`	Indicates whether the download is expected to be displayed inline or to be downloaded as an attachment.
contentLength	`number`	The size of the downloaded entity body.
mimeType	`string`	The mime type of the resource to be downloaded.
url	`string`	The URL of the resource to be downloaded.

message

Fired when a web message has been sent via window.parent.postMessage(message, targetOrigin) from inside the WebView.

Parameter	Type	Description
data	`string`	The sent message.

Change Events

urlChanged

Fired when the url property has changed.

Parameter	Type	Description
value	`string`	The new value of url.

htmlChanged

Fired when the html property has changed.

Parameter	Type	Description
value	`string`	The new value of html.

canGoForwardChanged

Fired when the canGoForward property has changed.

Parameter	Type	Description
value	`boolean`	The new value of canGoForward.

canGoBackChanged

Fired when the canGoBack property has changed.

Parameter	Type	Description
value	`boolean`	The new value of canGoBack.

Tabris.js 3.0