uniapp中web-view组件嵌入H5及跨端跳转实现
本文详解在uniapp项目中利用web-view组件嵌入H5页面的具体步骤，包括配置src属性及页面注册。针对H5跳转回APP指定页面的需求，重点对比原生H5与uniapp开发H5在调用跳转API时的差异，并给出引入SDK及修正方法名的解决方案，实现跨端通信与页面跳转。
uni-app项目内嵌入H5页面的方法
利用UniApp的web-view组件实现H5页面嵌入。
安装uni-app依赖，在pages目录下新建容器页面（如"WebPage.vue"）。
在template中配置web-view组件，指定src属性为H5地址，示例如下：
<template>
<view class="container">
<!-- web-view组件 -->
<web-view :src="url"></web-view>
</view>
</template>在script中定义data并初始化url为H5地址，示例如下：
<script>
export default {
data() {
return {
url: 'https://www.example.com' // H5页面地址
}
},
}
</script>在manifest.json中注册该页面以确认可访问。
运行项目，进入WebPage页面即自动加载指定H5内容。
web-view 作为网页承载容器，默认铺满页面（nvue需手动设宽高）。
各小程序平台需在后台配置web-view加载的url域名白名单，含嵌套iframe的url。
扩展内容：
Uniapp嵌入H5并实现H5跳转至APP指定页面
应用场景
需求为APP内嵌网络H5页面（非APP项目内），实现单点登录及从H5跳转至APP指定页面。
Web-View组件
uniapp提供web-view组件作为浏览器容器，自动铺满页面，详见uniapp官网文档。
https://uniapp.dcloud.net.cn/component/web-view.html#web-view官方示例展示的是APP嵌入原生H5页面的场景。
参考官方demo中原生H5页面使用的HTML代码。
APP中使用web-view嵌入H5页面的实现代码如下。
<template>
<view>
<web-view src="https://uniapp.dcloud.io/static/web-view.html"></web-view>
</view>
</template>src可为任意网址（如www.baidu.com），此处为方便测试使用官方H5地址，官方原生h5代码如下。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no" />
<title>网络网页</title>
<style type="text/css">
.btn {
display: block;
margin: 20px auto;
padding: 5px;
background-color: #007aff;
border: 0;
color: #ffffff;
height: 40px;
width: 200px;
}
.btn-red {
background-color: #dd524d;
}
.btn-yellow {
background-color: #f0ad4e;
}
.desc {
padding: 10px;
color: #999999;
}
.post-message-section {
visibility: hidden;
}
</style>
</head>
<body>
<p class="desc">web-view 组件加载网络 html 示例。点击下列按钮，跳转至其它页面。</p>
<div class="btn-list">
<button class="btn" type="button" data-action="navigateTo">navigateTo</button>
<button class="btn" type="button" data-action="redirectTo">redirectTo</button>
<button class="btn" type="button" data-action="navigateBack">navigateBack</button>
<button class="btn" type="button" data-action="reLaunch">reLaunch</button>
<button class="btn" type="button" data-action="switchTab">switchTab</button>
</div>
<div class="post-message-section">
<p class="desc">网页向应用发送消息，注意：小程序端应用会在此页面后退时接收到消息。</p>
<div class="btn-list">
<button class="btn btn-red" type="button" id="postMessage">postMessage</button>
</div>
</div>
<script type="text/javascript">
var userAgent = navigator.userAgent;
if (userAgent.indexOf('AlipayClient') > -1) {
// 支付宝小程序的 JS-SDK 防止 404 需要动态加载，如果不需要兼容支付宝小程序，则无需引用此 JS 文件。
document.writeln('<script src="https://appx/web-view.min.js"' + '>' + '<' + '/' + 'script>');
} else if (/QQ/i.test(userAgent) && /miniProgram/i.test(userAgent)) {
// QQ 小程序
document.write(
'<script type="text/javascript" src="https://qqq.gtimg.cn/miniprogram/webview_jssdk/qqjssdk-1.0.0.js"><\/script>'
);
} else if (/miniProgram/i.test(userAgent) && /micromessenger/i.test(userAgent)) {
// 微信小程序 JS-SDK 如果不需要兼容微信小程序，则无需引用此 JS 文件。
document.write('<script type="text/javascript" src="https://res.wx.qq.com/open/js/jweixin-1.4.0.js"><\/script>');
} else if (/toutiaomicroapp/i.test(userAgent)) {
// 头条小程序 JS-SDK 如果不需要兼容头条小程序，则无需引用此 JS 文件。
document.write(
'<script type="text/javascript" src="https://s3.pstatp.com/toutiao/tmajssdk/jssdk-1.0.1.js"><\/script>');
} else if (/swan/i.test(userAgent)) {
// 百度小程序 JS-SDK 如果不需要兼容百度小程序，则无需引用此 JS 文件。
document.write(
'<script type="text/javascript" src="https://b.bdstatic.com/searchbox/icms/searchbox/js/swan-2.0.18.js"><\/script>'
);
} else if (/quickapp/i.test(userAgent)) {
// quickapp
document.write('<script type="text/javascript" src="https://quickapp/jssdk.webview.min.js"><\/script>');
}
if (!/toutiaomicroapp/i.test(userAgent)) {
document.querySelector('.post-message-section').style.visibility = 'visible';
}
</script>
<!-- uni 的 SDK -->
<!-- 需要把 uni.webview.1.5.4.js 下载到自己的服务器 -->
<script type="text/javascript" src="https://unpkg.com/@dcloudio/uni-webview-js@0.0.3/index.js"></script>
<script type="text/javascript">
// 待触发 `UniAppJSBridgeReady` 事件后，即可调用 uni 的 API。
document.addEventListener('UniAppJSBridgeReady', function() {
uni.postMessage({
data: {
action: 'message'
}
});
uni.getEnv(function(res) {
console.log('当前环境：' + JSON.stringify(res));
});
document.querySelector('.btn-list').addEventListener('click', function(evt) {
var target = evt.target;
if (target.tagName === 'BUTTON') {
var action = target.getAttribute('data-action');
switch (action) {
case 'switchTab':
uni.switchTab({
url: '/pages/tabBar/API/API'
});
break;
case 'reLaunch':
uni.reLaunch({
url: '/pages/tabBar/component/component'
});
break;
case 'navigateBack':
uni.navigateBack({
delta: 1
});
break;
default:
uni[action]({
url: '/pages/component/button/button'
});
break;
}
}
});
document.getElementById('postMessage').addEventListener('click', function() {
uni.postMessage({
data: {
action: 'message'
}
});
});
});
</script>
</body>
</html>提取关键代码部分。
<!-- 需要把 uni.webview.1.5.4.js 下载到自己的服务器 --> 导入web-view 的SDK
<script type="text/javascript" src="https://unpkg.com/@dcloudio/uni-webview-js@0.0.3/index.js"></script>跳转至APP页面的关键方法为uni.reLaunch。
uni.reLaunch({
url: '/pages/tabBar/component/component'
});该方法用于跳转至APP指定页面，url为APP页面路径，APP项目目录结构如下。
建议自行学习相关跳转方法。
case 'switchTab':
uni.switchTab({
url: '/pages/tabBar/API/API'
});
break;
case 'reLaunch':
uni.reLaunch({
url: '/pages/tabBar/component/component'
});
break;
case 'navigateBack':
uni.navigateBack({
delta: 1
});
break;上述代码解决APP嵌入原生H5后跳转回APP的问题，但uniapp开发的H5中uni.reLaunch仅能跳转本地页面，解决方法如下：1. 下载官网web-view的SDK。
官方原生H5 demo导入了关键Js文件，可通过浏览器打开查看。
https://unpkg.com/@dcloudio/uni-webview-js@0.0.3/index.js
复制JS代码，在H5项目中创建web-view.js文件并填入上述代码。
2. 在H5项目的main.js文件中导入该文件。
3. 原生H5与uniapp开发的H5使用的跳转方法不同。
uni.webView.reLaunch({
url: '/pages/tabBar/component/component'
});区别在于uniapp开发的H5跳转方法需加上webView前缀。
本文介绍完uniapp项目中嵌套H5页面的方法，更多内容请搜索本站文章或继续浏览相关文章，感谢支持！
Mock.js 拦截失效或数据格式错误的常见原因及排查
2026-11-05 10:11:59
Java和JavaScript名字像但没关系：辨析Java、JavaWeb与JS
2026-11-04 09:30:54
CodePen、JSFiddle与RunJS对比：哪款JS在线运行工具更适合你？
2026-11-03 16:46:57
JS 统计图渲染空白或报错怎么排查？常见问题解决指南
2026-11-03 09:49:40
flv.js 常见报错 MediaError 与解码失败排查指南
2026-11-02 10:29:29