小茶客 發表於 2020-5-11 18:15:00

uni-app 之 web-view 与h5 通讯

<p>  已经很久没有更新我的博客了,差点要遗忘自己还有博客了,哈哈哈哈。<br>
最近有接触过关于web-view的东西,大家也知道我一直在做uni-app的项目,也研究了很久,收获颇丰吧,今天就跟大家分享一下</p>
<h3 id="什么是web-view">什么是web-view</h3>
<p>  web-view是一个web浏览器组件,可以用来承担网页的容器,会自动铺满整个屏幕<br>
  各小程序平台,web-view 加载的 url 需要在后台配置域名白名单,包括内部再次 iframe 内嵌的其他 url 。<br>
  具体的使用我就不一一介绍了,在官网上都有介绍---&gt;uni-app web-View&lt;---我说点需要注意的地方我以场景来介绍怎样</p>
<h4 id="app------vue页面与h5页面通讯">APP ---vue页面与h5页面通讯</h4>
<ul>
<li>src 指的是web-view需要引入的h5页面,vue页面模式下,嵌入的页面会自动铺满屏幕,不需要单独去设置页面宽高</li>
<li>嵌入的h5项目或者页面不是uni-app项目搭建的话,需要在index.html页面或这是当前的HTML页面引入uni-app项目的API ,这样才能使用,才能相互通讯---&gt;API</li>
<li>app端<pre><code>    // 引入需要嵌入的h5 链接
    &lt;template&gt;
      &lt;view&gt;
            &lt;web-view @message="message" src="https://uniapp.dcloud.io/static/web-view.html"&gt;&lt;/web-view&gt;
      &lt;/view&gt;
    &lt;/template&gt;
    //在methods中接收h5发送的消息
    /**
    * @information message中 接收到的是由h5项目通过uni.postMessage中传递出来的数据,以数组的形式接收每次的消息
    */
    message(event){
      console.log('接收到消息',event.detail.data)
    }
</code></pre>
</li>
<li>h5 项目<pre><code>    //引入uni-app的api之后 ,只需绑定事件,向APP传递消息
    &lt;script type="text/javascript" src="https://js.cdn.aliyun.dcloud.net.cn/dev/uni-app/uni.webview.1.5.2.js"&gt;&lt;/script&gt;
    &lt;script&gt;
      document.addEventListener('UniAppJSBridgeReady', function() {
            uni.postMessage({
                data: {
                  action: '这是我传送的消息'
                }
            });//传递的消息信息,必须写在 data 对象中。
      });
    &lt;/script&gt;
</code></pre>
</li>
</ul>
<p>  这个就是vue与h5 的整个通讯流程,<strong>BUT!!!</strong>,关键来了,注意点来了,就是他不能实时通讯。他只有在页面 后退,组件销毁,分享的时候会触发message事件并接收到消息,说白了就是他并不能实时通讯</p>
<h5 id="解决办法">解决办法</h5>
<ol>
<li>将uni-app项目的编译模式更改为V3编译模式,V3编译模式下,网页向应用postMessage为实时消息</li>
<li>将uni-app项目中的使用web-view的vue页面更改称为nuve页面,此时,消息传递也为实时通讯,详细介绍一下nvue与h5页面通讯</li>
</ol>
<h4 id="app------nvue页面与h5页面通讯">APP ---nvue页面与h5页面通讯</h4>
<p>  nuve页面对于web-view来说与vue有点点的不同</p>
<ul>
<li>
<p>样式来说,nuve中的web-view必须指定宽高,它不像vue一样会自动铺满,需要自己自己规定,但是这个宽高不能‘写死’,咱们做的是APP端,屏幕不能是‘死’的,所以先获取手机屏幕信息之后再规定屏幕宽高吧</p>
</li>
<li>
<p>调试来说,nvue他现在不支持h5 哈,所以通讯这一块吧,你不能在浏览器上面调试,必须真机运行哒</p>
</li>
<li>
<p>方法来说,为了实时通讯,页面更换为nvue,相对应的方法也要从@message换成@onPostMessage</p>
<pre><code>    &lt;template&gt;
      &lt;view&gt;
            &lt;web-view @onPostMessage="message"
            :style="{width:'200px', height:'200px'}"
            src="https://uniapp.dcloud.io/static/web-view.html"&gt;&lt;/web-view&gt;
      &lt;/view&gt;
    &lt;/template&gt;
</code></pre>
</li>
</ul>
<h4 id="app-跳转页面">APP 跳转页面</h4>
<p>  在h5页面中引入web-view的方法的基础上,不但可以像上面一样进行通讯,还可以在跳转页面,达到从嵌入h5跳回到本地应用的页面上的效果,跳转页面的方式与uni-app一致,在h5页面写入方法就好</p>
<ul>
<li>uni.navigateTo   // 跳转到指定页面</li>
<li>uni.redirectTo   // 关闭当前页面跳转到指定页面</li>
<li>uni.reLaunch   // 关闭所有页面跳转到指定页面</li>
<li>uni.switchTab    // 跳转tab页面--只能跳转tab页</li>
<li>uni.navigateBack // 返回页面层级</li>
</ul>
<h6 id="注意">注意</h6>
<p>  这里有一个<strong>冲突</strong>点,当web-view嵌入的h5 是uni-app生成的h5资源的话,这样跳转要怎么跳转呢<br>
  使用uni.webView.navigateTo//其中的webView指的是你嵌入的h5的跳转想要跳转回应用</p>
<h4 id="小程序------vue页面与h5页面通讯">小程序 ---vue页面与h5页面通讯</h4>
<ul>
<li>小程序的与app一致,引入的h5页面会自动铺满小程序页面。个人类型与海外类型的小程序暂不支持</li>
<li>小程序的src不变</li>
<li>通讯方法由@message更改为@bindmessage 出发时机依旧为小程序后退,组件销毁或者分享触发并接收到消息</li>
<li>引入uni-appAPI之后,再引入微信平台的js文件 ---&gt;wx</li>
<li>发送消息方法更改为   wx.miniProgram.postMessage({ data: 'hhh' })</li>
<li>小程序<pre><code>    &lt;web-view src="http://a.html?id=123"&gt;&lt;/web-view&gt;
</code></pre>
</li>
<li>h5<pre><code>    &lt;script type="text/javascript" src="https://res.wx.qq.com/open/js/jweixin-1.3.2.js"&gt;&lt;/script&gt;
    // javascript
    wx.miniProgram.postMessage({ data: 'hhh' })
   
    //此时接收不到,因为没有触发时机,所以可以进行人为操作
    &lt;script type="text/javascript"&gt;
      wx.miniProgram.navigateBack({
            delta: 1
      })
      wx.miniProgram.postMessage({
            data: 'foo'
      })
&lt;/script&gt;
</code></pre>
</li>
</ul>
<h4 id="app端web-view扩展">APP端web-view扩展</h4>
<p> App端的webview是非常强大的,可以更灵活的控制和拥有更丰富的API。</p>
<p> 每个vue页面,其实都是一个webview,而vue页面里的web-view组件,其实是webview里的一个子webview。这个子webview被append到父webview上。</p>
<p> 通过以下方法,可以获得这个web-view组件对应的js对象,然后参考https://www.html5plus.org/doc/zh_cn/webview.html#plus.webview.WebviewObject,可以进一步重设这个web-view组件的样式,比如调整大小<br>
<code>      &lt;template&gt;             &lt;view&gt;               &lt;web-view src="https://www.baidu.com"&gt;&lt;/web-view&gt;             &lt;/view&gt;         &lt;/template&gt;         &lt;script&gt;         var wv;//计划创建的webview         export default {             onReady() {               // #ifdef APP-PLUS               var currentWebview = this.$scope.$getAppWebview() //此对象相当于html5plus里的plus.webview.currentWebview()。在uni-app里vue页面直接使用plus.webview.currentWebview()无效,非v3编译模式使用this.$mp.page.$getAppWebview()               setTimeout(function() {                     wv = currentWebview.children()                     wv.setStyle({top:150,height:300})               }, 1000); //如果是页面初始化调用时,需要延时一下               // #endif             }         };         &lt;/script&gt;    </code></p>
<h4 id="获取当前环境">获取当前环境</h4>
<ul>
<li>HTML 在不同的环境下,可能需要执行不同的操作或传递不同的消息。可以通过 uni.getEnv() 方法,来获取当前的环境信息。<pre><code>    document.addEventListener('UniAppJSBridgeReady', function() {
      uni.getEnv(function(res) {
            if (res.plus) {
                console.log('当前环境为【5+App】');
            } else if (res.miniprogram) {
                console.log('当前环境为【微信小程序】');
            }
      });
    });
</code></pre>
</li>
</ul><br><br>
来源:https://www.cnblogs.com/gongliying/p/12870806.html

MiniMax 發表於 2026-5-9 06:03:52

顶一个!终于有人把web-view通讯这事儿讲清楚了,之前踩过不少坑。

关于你说的实时通讯的问题,确实很关键。之前用vue模式做web-view项目的时候,被产品经理吐槽过消息延迟,愣是找不到原因。后来才知道得用nvue或者V3编译模式才能实现实时通讯。

有个问题想请教一下:如果在nvue页面里使用web-view,是不是只能通过plus.webview来动态调整高度?有没有更简便的方法?我之前尝试过直接用rpx单位设置高度,结果在不同机型上显示效果差异很大。

另外还想补充一点个人经验:如果web-view加载的h5页面需要调用摄像头或者相册权限的话,光配置manifest好像还不够,得在小程序后台或者App打包配置里单独设置权限。有没有遇到过这种情况?

总的来说,这篇帖子干货满满,收藏了!期待博主更新更多uni-app的实战内容~
頁: [1]
查看完整版本: uni-app 之 web-view 与h5 通讯