前端技巧——iframe + postMessage进行页面通信

应用场景

我们知道iframe标签可以将另外一个页面嵌入到该标签当中,相当于开启一个画中画。这个一般就用来嵌入一个统一的登陆验证功能。那么这样就会存在一个问题,我们需要嵌入的子页面能够和当前的主页面进行通信,所以我们就需要使用某种方法来实现不同源之间的页面的通信功能,所以我们需要postMessage

iframe标签文档:https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/iframe

postMessage文档:https://developer.mozilla.org/zh-CN/docs/Web/API/Window/postMessage

环境说明

我们在vue3的环境下来实现该功能,你可以使用如下命令来实现创建一个vue3模板

pnpm create vue@latest

功能介绍

我们需要实现父页面对子页面 发送消息与接收消息+子页面对父页面 发送消息与接收消息

这四个功能完成之后随便怎么嵌入都没问题

父页面对子页面发送消息

我们首先在父项目定义一个iframe标签,书写好html

html 复制代码
<iframe id="iframe" src="http://localhost:5174" frameborder="0"></iframe>

后面我们参考postMessage的文档,可以知道,他需要一个窗口对象才能使用,恰巧我们的iframe提供了contentWindow属性来获取这样一个对象,又为了防止网络出现问题导致代码执行后子页面还没有出来,我们可以使用onload回调后在iframe设置等待子页面加载后执行

javascript 复制代码
// 发送消息给子页面
  const iframe = document.getElementById('iframe')
  console.log('xxxxx', iframe)
  iframe.onload = () => {
    iframe.contentWindow.postMessage({ data: '你好', type: 'DIY' }, 'http://localhost:5174/')
  }

这里我们统一使用了我们自己的数据结构,来区分哪些消息是我们自主发出的

子页面接受父页面传来的消息

javascript 复制代码
window.addEventListener(
  'message',
  (e) => {
    // 父窗口发送的消息
    if (e.origin === 'http://localhost:5173' && e.data.type === 'DIY') {
      console.log('xxxxx', e.origin, e.source, e.data)
    }
  },
  false
)

子页面对父页面发送消息

javascript 复制代码
window.parent.postMessage({ data: '你好', type: 'DIY' }, 'http://localhost:5173')

父页面接受子页面传来的消息

javascript 复制代码
  // 给父页面添加监听获取子页面发送来的消息
  window.addEventListener('message', (event) => {
    if (event.origin === 'http://localhost:5174' && event?.data?.type === 'DIY') {
      console.log('event', event.origin, event.source, event.data)
    }
  })

有了上面这些功能,相信你也可以自己实现一个统一登陆平台了,加油吧,下面是代码

代码

父页面代码

javascript 复制代码
<template>
  <div class="welcome">
    <div class="title">这里是欢迎标签</div>
    <iframe id="iframe" src="http://localhost:5174" frameborder="0"></iframe>
  </div>
</template>

<script setup lang="ts">
import { onMounted } from 'vue'
onMounted(() => {
  // 发送消息给子页面
  const iframe = document.getElementById('iframe')
  console.log('xxxxx', iframe)
  iframe.onload = () => {
    iframe.contentWindow.postMessage({ data: '你好', type: 'DIY' }, 'http://localhost:5174/')
  }
  // 给父页面添加监听获取子页面发送来的消息
  window.addEventListener('message', (event) => {
    if (event.origin === 'http://localhost:5174' && event?.data?.type === 'DIY') {
      console.log('event', event.origin, event.source, event.data)
    }
  })
})
</script>

子页面代码

javascript 复制代码
<template>
  <div class="content">
    <div>这是子页面</div>
    <input type="text" v-model="inputText" />
    <button @click="sub">发送</button>
  </div>
</template>

<script setup lang="ts">
import { ref } from 'vue'

const sub = () => {
  console.log('打印信息')
  window.parent.postMessage({ data: '你好', type: 'DIY' }, 'http://localhost:5173')
}

const inputText = ref('')
window.addEventListener(
  'message',
  (e) => {
    // 父窗口发送的消息
    if (e.origin === 'http://localhost:5173' && e.data.type === 'DIY') {
      console.log('xxxxx', e.origin, e.source, e.data)
    }
  },
  false
)
</script>

<style scoped>
header {
  line-height: 1.5;
  max-height: 100vh;
}

.logo {
  display: block;
  margin: 0 auto 2rem;
}

nav {
  width: 100%;
  font-size: 12px;
  text-align: center;
  margin-top: 2rem;
}

nav a.router-link-exact-active {
  color: var(--color-text);
}

nav a.router-link-exact-active:hover {
  background-color: transparent;
}

nav a {
  display: inline-block;
  padding: 0 1rem;
  border-left: 1px solid var(--color-border);
}

nav a:first-of-type {
  border: 0;
}

@media (min-width: 1024px) {
  header {
    display: flex;
    place-items: center;
    padding-right: calc(var(--section-gap) / 2);
  }

  .logo {
    margin: 0 2rem 0 0;
  }

  header .wrapper {
    display: flex;
    place-items: flex-start;
    flex-wrap: wrap;
  }

  nav {
    text-align: left;
    margin-left: -1rem;
    font-size: 1rem;

    padding: 1rem 0;
    margin-top: 1rem;
  }
}
</style>
相关推荐
科技探秘人10 分钟前
Chrome与火狐哪个浏览器的隐私追踪功能更好
前端·chrome
科技探秘人10 分钟前
Chrome与傲游浏览器性能与功能的深度对比
前端·chrome
JerryXZR16 分钟前
前端开发中ES6的技术细节二
前端·javascript·es6
七星静香18 分钟前
laravel chunkById 分块查询 使用时的问题
java·前端·laravel
q24985969321 分钟前
前端预览word、excel、ppt
前端·word·excel
小华同学ai26 分钟前
wflow-web:开源啦 ,高仿钉钉、飞书、企业微信的审批流程设计器,轻松打造属于你的工作流设计器
前端·钉钉·飞书
Gavin_91535 分钟前
【JavaScript】模块化开发
前端·javascript·vue.js
懒大王爱吃狼2 小时前
Python教程:python枚举类定义和使用
开发语言·前端·javascript·python·python基础·python编程·python书籍
逐·風6 小时前
unity关于自定义渲染、内存管理、性能调优、复杂物理模拟、并行计算以及插件开发
前端·unity·c#
Devil枫6 小时前
Vue 3 单元测试与E2E测试
前端·vue.js·单元测试