Vue3中teleport 组件是干什么用的

简介: Vue3中teleport 组件是干什么用的

teleport 组件作用

teleport 组件是 Vue 3 中引入的一个新组件,它的作用是将组件的内容渲染到 DOM 中的任何位置。使用场景如处理弹出框、模态框、通知栏等需要将组件内容挂载到 DOM 结构中其他位置。

使用 teleport 可以轻松实现在组件内部定义的内容在 DOM 树的其他位置动态渲染,而不受组件嵌套的限制。这在处理全局提示、弹窗等需求时比较方便。

teleport 的基本语法如下:

<teleport to="目标选择器">
  <!-- 要移动的内容 -->
</teleport>

这里的to 属性是一个 CSS 选择器,表示要移动到的目标位置。teleport 组件内部的内容将被移动到目标位置,而不是在组件自身的位置进行渲染。

以下是一个简单的示例,演示了如何使用 teleport:模态框的内容被包裹在 teleport 组件内,通过 to 属性指定目标位置为 "body",这样模态框的内容就会被渲染到 body 元素下,而不是在组件自身的位置。这使得模态框可以脱离组件的嵌套结构,灵活地渲染到任意位置。


<template>
  <div>
    <button @click="toggleModal">打开模态框</button>

    <!-- 使用 teleport 将模态框内容渲染到 body 元素下 -->
    <teleport to="body" v-if="isModalVisible">
      <div class="modal">
        <button @click="toggleModal">关闭模态框</button>
        <p>这是模态框的内容</p>
      </div>
    </teleport>
  </div>
</template>

<script>
export default {
  data() {
    return {
      isModalVisible: false,
    };
  },
  methods: {
    toggleModal() {
      this.isModalVisible = !this.isModalVisible;
    },
  },
};
</script>

<style>
/* 模态框的样式 */
.modal {
  position: fixed;
  top: 50%;
  left: 50%;
  transform: translate(-50%, -50%);
  padding: 20px;
  background-color: white;
  box-shadow: 0 0 10px rgba(0, 0, 0, 0.5);
}
</style>

teleport实现原理

teleport 组件的实现原理涉及到 Vue 3 中的 Portal(传送门)机制。Portal 允许在组件的模板中将内容渲染到 DOM 树的其他位置,而不受组件嵌套的限制。

实现 Portal 的关键在于使用 teleport 组件包裹要移动的内容,并通过 to 属性指定目标位置的选择器。在组件渲染时,teleport 会将其内部的内容移动到目标位置,而不是在组件自身的位置进行渲染。

以下是 teleport 组件的简化实现原理:

  1. teleport 组件在内部使用了 Vue 3 中的 Teleport 组件。在 teleport 组件的 mounted 钩子中,会使用 createTeleport 函数创建一个 Teleport 实例,并将目标选择器传递给它。
  2. createTeleport 函数内部,它会通过 querySelector 查找目标选择器对应的 DOM 元素。
  3. Teleport 实例会监听到内容的变化,一旦内容发生变化,它就会将内容移动到目标位置。
  4. teleport 组件销毁时,它会清理相应的资源,确保不会造成内存泄漏。

下面是一个简化的 teleport 组件的实现示例:这个示例中,TeleportComponent 是一个简化的 teleport 组件,通过 createTeleport 函数模拟了一个 Teleport 实例。在实际情况中,Vue 3 的 Teleport 组件是底层实现这个机制的,而不需要手动创建和管理 Teleport 实例。这个示例只是为了说明实现的基本原理。

import { createApp, ref, h, Teleport } from 'vue';

const TeleportComponent = {
  props: ['to'],
  setup(props, { slots }) {
    const teleportRef = ref(null);

    // 创建 Teleport 实例
    const teleportInstance = createTeleport(teleportRef, props.to);

    // 监听内容变化,将内容移动到目标位置
    teleportInstance.onUpdated(() => {
      const content = slots.default();
      teleportInstance.move(content);
    });

    return () => h(Teleport, { ref: teleportRef });
  },
};

// 创建 Teleport 实例的辅助函数
function createTeleport(teleportRef, targetSelector) {
  const listeners = [];

  const onUpdated = (callback) => {
    listeners.push(callback);
  };

  const move = (content) => {
    const target = document.querySelector(targetSelector);
    if (target && teleportRef.value) {
      target.appendChild(content);
    }
  };

  // 模拟 Teleport 实例
  const teleportInstance = {
    onUpdated,
    move,
  };

  // 在 teleportRef 更新时触发 onUpdated 回调
  teleportRef.value.$watch('$el', () => {
    listeners.forEach((callback) => callback());
  });

  return teleportInstance;
}

const app = createApp({
  components: {
    TeleportComponent,
  },
  template: `
    <div>
      <TeleportComponent to="#target">
        <p>这是要传送的内容</p>
      </TeleportComponent>

      <div id="target"></div>
    </div>
  `,
});

app.mount('#app');

每天学习一点点,十天提高一大步!

目录
相关文章
|
8天前
|
JavaScript
vue组件中的插槽
本文介绍了Vue中组件的插槽使用,包括单个插槽和多个具名插槽的定义及在父组件中的使用方法,展示了如何通过插槽将父组件的内容插入到子组件的指定位置。
|
6天前
|
缓存 监控 UED
升级 Vue3 时,如何减少打包体积的增加?
升级 Vue3 时,如何减少打包体积的增加?
85 59
|
6天前
|
JavaScript
在vue3中(vite)引入unocss,安装配置unocss
在vue3中(vite)引入unocss,安装配置unocss
|
6天前
|
API UED
升级 Vue3 后,项目的打包体积会有什么变化?
升级 Vue3 后,项目的打包体积会有什么变化?
93 57
|
7天前
|
缓存 JavaScript 前端开发
「offer来了」从基础到进阶原理,从vue2到vue3,48个知识点保姆级带你巩固vuejs知识体系
该文章全面覆盖了Vue.js从基础知识到进阶原理的48个核心知识点,包括Vue CLI项目结构、组件生命周期、响应式原理、Composition API的使用等内容,并针对Vue 2与Vue 3的不同特性进行了详细对比与讲解。
「offer来了」从基础到进阶原理,从vue2到vue3,48个知识点保姆级带你巩固vuejs知识体系
|
6天前
|
API UED
如何实现Vue2项目升级Vue3?
如何实现Vue2项目升级Vue3?
14 1
|
6天前
|
JavaScript
vue 函数化组件
vue 函数化组件
|
8天前
|
JavaScript API
再不学vue3就没有人要你了!速来围观vue3
这篇技术文章介绍了作者从最初对学习 Vue3 抵触到最终决定投入学习的心路历程,展示了 Vue3 相较于 Vue2 的诸多改进和新特性,如更优的性能、更小的代码体积及更佳的 TypeScript 支持。文章重点阐述了 Vue3 中 createApp 的使用变化、emits 机制、多事件处理、Fragment 的引入等重要功能升级。此外,还深入探讨了 Composition API 和 Options API 的区别,强调 Composition API 在代码组织和逻辑复用方面的优势,并给出了在不同项目规模中选择合适 API 的建议。
20 0
|
8天前
|
JavaScript 前端开发 UED
组件库实战 | 用vue3+ts实现全局Header和列表数据渲染ColumnList
该文章详细介绍了如何使用Vue3结合TypeScript来开发全局Header组件和列表数据渲染组件ColumnList,并提供了从设计到实现的完整步骤指导。
|
JavaScript
Vue的非父子组件之间传值
全局事件总线 一种组件间通信的方式,适用于任意组件间通信
下一篇
无影云桌面