8.7 版本发布—WinterCG 兼容性第一部分
了解更多

<WebView> 是一个用于渲染网页内容的 UI 组件。内容可以来自远程 URL、本地文件或内联字符串。

另请参阅:HtmlView

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

提示

为了能够在 Android 上的 WebView 中使用手势,请禁用缩放控件

属性

src

ts
src: string

要在 WebView 中加载的源。该值可以是有效的 HTTP URL、本地 HTML 文件的路径或 HTML 字符串。

示例

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

不安全的 URL

根据设备的软件版本,不安全的 URL 可能会被阻止 (http://),建议始终使用安全的 URL (https://)。

canGoBack

ts
canGoBack: boolean

获取一个指示 WebView 是否可以后退的值。

canGoForward

ts
canGoForward: boolean

获取一个指示 WebView 是否可以前进的值。

disableZoom

ts
disableZoom: boolean

禁用 WebView 中的缩放。

iosAllowInlineMediaPlayback

ts
iosAllowInlineMediaPlayback: boolean

在 iOS 上启用内联媒体播放。默认情况下,WebView 会强制 iPhone 进入全屏媒体播放。**仅限 iOS**。

...继承的

有关未显示的其他继承属性,请参阅API 参考

方法

stopLoading()

ts
stopLoading(): void

停止加载当前内容(如果有)。

goBack()

ts
goBack(): void

使 WebView 后退。

goForward()

ts
goForward(): void

使 WebView 前进。

reload()

ts
reload(): void

重新加载当前 URL。

事件

loadStarted

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

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

当页面开始在 <WebView> 中加载时发出。

参见 LoadEventData

loadFinished

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

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

当页面开始在 <WebView> 中加载时发出。

参见 LoadEventData

原生组件

上一个
TimePicker