一、为什么需要 WebView?
在微信小程序开发中,大多数功能可以用原生组件实现,但仍有一些情况需要加载 已有网页、H5 活动页、客服页、表单页或外部系统。此时,就需要官方提供的组件 —— WebView。
WebView 可以让小程序在自身页面内打开网页,实现'嵌入式'页面展示,避免跳转外部浏览器,提高用户体验。
二、WebView 的基础使用方法
要使用 WebView,需要满足两个前提:
1. 后端域名需加入业务域名白名单
路径:微信小程序后台 → 开发 → 开发管理 → 业务域名 只有加入白名单的 HTTPS 域名才能被 WebView 加载。
2. 页面中直接使用 WebView 组件
WXML 示例:
<web-view src="https://example.com/h5/index.html"></web-view>
JS 示例(可选参数):
Page({ data: { url: 'https://example.com/h5/index.html' }})
三、WebView 常见的应用场景
1. 已有 H5 内容复用
比如活动页、营销页、内容页早已用 Vue/React/H5 做好,无需重复开发,可直接嵌入 WebView。
2. 第三方系统的嵌入
常见场景:
- 客服系统
- 支付订单查询页
- 表单收集页(如问卷星、金数据)
- 内部后台某些查询页面
只需授权域名,通过 WebView 即可展示。
3. 复杂富文本内容展示
例如文章、长图文、说明文档等。如果原生组件排版复杂或成本高,可直接用 WebView 加载 H5。
4. 跨端统一接口管理
App + H5 + 小程序共享同一个网页页头、内容逻辑,此时小程序作为一层壳嵌入 WebView,减少重复开发。
四、WebView 的限制与注意事项
虽然 WebView 很方便,但它有一些限制必须知道:
1. 不支持非 HTTPS 站点
必须是 https,且必须在白名单里。
2. 小程序端无法直接操作 WebView 内部的 DOM
WebView 内部本质是独立的网页容器:
- 小程序不能获取网页内容
- 不能直接修改 DOM
- 不能访问网页 localStorage
你需要通过 postMessage 通信 来交互。

