uni-app 中 web-view 与网页双向通信实现指南

作者:工具松鼠时间:2026-11-01 02:58:24浏览:290

本文详解 uni-app 中 web-view 组件与 H5 页面的双向通信机制。涵盖 APP 端通过 $getAppWebview 获取实例并注入 JS,以及 H5 端引入 uni SDK 调用 postMessage 发送消息的具体步骤与代码示例。

APP 端获取 Webview 实例与注入 JS

在 APP 开发中,首先需要获取 this.$scope.$getAppWebview() 以拿到当前页面的 webview 实例。拿到该实例后,可以利用 evalJS 方法向网页注入一段 JavaScript 代码,从而实现对网页中对象或函数的调用。

<template>  
    <view>  
      <web-view ref="webview" src="http://192.168.1.79:6446/demo.html" @message="handleMessage"></web-view> 
    </view>  
</template>  
<script>  
	var wv;
	export default {  
		onLoad() { 
			var currentWebview = this.$scope.$getAppWebview(); //获取当前页面的webview对象    
			setTimeout(function() {  
				wv = currentWebview.children()[0];  
			}, 300); //如果是页面初始化调用时,需要延时一下 
		},
		methods: {  
      // 接收网页中发送来的消息
			handleMessage(evt) { 
				console.log('接收到的消息:' + JSON.stringify(evt));  
				this.evalJS()
			},
			evalJS() {
				wv.evalJS(`
					num+=1; // 网页中的变量
					alertaa() // 网页中的事件
				`)
			}
		}  
	}  
</script>

H5 端引入 Uni SDK

若要在网页中调用 uni-app 提供的方法,必须在 H5 页面中引入 uni 官方提供的 SDK 文件。

<!-- 微信 JS-SDK 如果不需要兼容小程序,则无需引用此 JS 文件。 -->  
<script type="text/javascript" src="https://res.wx.qq.com/open/js/jweixin-1.4.0.js"></script>  
<!-- uni 的 SDK,必须引用。 -->  
<script type="text/javascript" src="https://js.cdn.aliyun.dcloud.net.cn/dev/uni-app/uni.webview.1.5.1.js"></script>  
<script>

基于 postMessage 的消息收发机制

在网页侧,通过调用 uni-app 提供的 postMessage 方法来发送消息。APP 端则需要在 webview 的 message 事件回调中,通过 event.detail.data 属性来接收并处理这些消息。

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Document</title>
</head>
<body>
  <button id="test">onPostMessage</button>
  <p id="num"></p>
  <!-- 微信 JS-SDK 如果不需要兼容小程序,则无需引用此 JS 文件。 -->  
  <script type="text/javascript" src="https://res.wx.qq.com/open/js/jweixin-1.4.0.js"></script>  
  <!-- uni 的 SDK,必须引用。 -->  
  <script type="text/javascript" src="https://js.cdn.aliyun.dcloud.net.cn/dev/uni-app/uni.webview.1.5.1.js"></script>  
  <script>
    var num = 1;
    document.getElementById("num").innerText = num;
    document.getElementById("test").onclick=()=>{
      console.log('clickHandle :>> ', );
      uni.getEnv(function(res) { // 使用getEnv可以判断当前环境
        console.log("当前环境:" + JSON.stringify(res));
      });
      uni.postMessage({  // 调用uniapp中的postMessage方法
        data: {  
            action: 'onPostMessage'  
        }  
      });  
    }
    function alertaa() {
      alert("evalJS"+num);
    }
  </script>
</body>
</html>

至此,uni-app 使用 web-view 与网页进行双向通信的配置与代码实现已全部介绍完毕。如需了解更多相关技术细节,建议查阅本站往期文章或继续浏览后续内容,感谢支持。

作者最新文章