WebView - 《Taro 文档帮助手册教程》

sidebar_label: WebView
类型
示例代码
WebViewProps

title: WebView

sidebar_label: WebView

web-view 组件是一个可以用来承载网页的容器，会自动铺满整个小程序页面。个人类型与海外类型的小程序暂不支持使用。

支持情况： WebView - 图1 WebView - 图2 WebView - 图3 WebView - 图4

参考文档

类型

ComponentType<WebViewProps>

示例代码

import Tabs from ‘@theme/Tabs’ import TabItem from ‘@theme/TabItem’

tsx
class App extends Component {
  handleMessage () {}

  render () {
    return (
      <WebView src='https://mp.weixin.qq.com/' onMessage={this.handleMessage} />
    )
  }
}

html
<template>
  <web-view src='https://mp.weixin.qq.com/' @message="handleMessage" />
</template>

WebViewProps

参数	类型	必填	说明
src	`string`	是	webview 指向网页的链接。可打开关联的公众号的文章，其它网页需登录小程序管理后台配置业务域名。
onMessage	`CommonEventFunction<onMessageEventDetail>`	否	网页向小程序 postMessage 时，会在特定时机（小程序后退、组件销毁、分享）触发并收到消息。e.detail = { data }
onLoad	`CommonEventFunction<onLoadEventDetail>`	否	网页加载成功时候触发此事件。e.detail = { src }
onError	`CommonEventFunction<onErrorEventDetail>`	否	网页加载失败的时候触发此事件。e.detail = { src }

API 支持度

API	微信小程序	H5
WebViewProps.src	✔️	✔️
WebViewProps.onMessage	✔️
WebViewProps.onLoad	✔️	✔️
WebViewProps.onError	✔️	✔️

onMessageEventDetail

参数	类型	说明
data	`any[]`	消息数据，是多次 postMessage 的参数组成的数组

onLoadEventDetail

参数	类型	说明
src	`string`	网页链接

onErrorEventDetail

参数	类型	说明
src	`string`	网页链接