Help prepare for 2025 → Answer 8 simple questions on our Fall Survey
Open Survey

<WebView> is a UI component for rendering web content. The content can be from a remote URL, a local file, or an inline string.

See also: HtmlView.

xml
<WebView src="https://nativescript.org/" />

Tip

To be able to use gestures inside a WebView on Android, disable zoom controls.

Props

src

ts
src: string

The source to load in the WebView. The value can be a valid HTTP URL, a path to a local HTML file, or a HTML string.

Example:

ts
webView.src = 'https://nativescript.org/'
webView.src = '~/assets/html/index.html'
webView.src = '<div><h1>Some static HTML</h1></div>'

Insecure URLs

Depending on the software version of the device, insecure URLs may be blocked (http://), it's recommended to always use secure URLs (https://).

canGoBack

ts
canGoBack: boolean

Gets a value indicating whether the WebView can navigate back.

canGoForward

ts
canGoForward: boolean

Gets a value indicating whether the WebView can navigate forward.

disableZoom

ts
disableZoom: boolean

Disable zooming in the WebView.

iosAllowInlineMediaPlayback

ts
iosAllowInlineMediaPlayback: boolean

Enables inline media playback on iOS. By default, WebView forces iPhone into fullscreen media playback. iOS only.

...Inherited

For additional inherited properties not shown, refer to the API Reference

Methods

stopLoading()

ts
stopLoading(): void

Stops loading the current content (if any).

goBack()

ts
goBack(): void

Navigates the WebView back.

goForward()

ts
goForward(): void

Navigates the WebView forward.

reload()

ts
reload(): void

Reloads the current url.

Events

loadStarted

ts
on('loadStarted', (args: EventData) => {
  const webView = arg.object as WebView

  console.log('WebView started loading', args.url)
})

Emitted when the page has started loading in the <WebView>.

See LoadEventData.

loadFinished

ts
on('loadFinished', (args: EventData) => {
  const webView = arg.object as WebView

  console.log('WebView finished loading', args.url)
})

Emitted when the page has started loading in the <WebView>.

See LoadEventData.

Native component

Previous
TimePicker