Vue3 的“空投”Teleport的使用

前言:Teleport是一个内置的组件,可以将一个组件内部的一部分"传送"到该组件的DOM结构外层的位置去

使用场景:

  1. 全屏模态框
  2. 在已经布局好的页面上,进入到特定页面,需要在布局组件上渲染特定的内容
  3. 预览模式下,将内容展示在页面不同的地方

以上就是我在项目中使用的场景,更详细可前往官网查看

会遇到什么问题呢?

js 复制代码
[Vue warn]: Failed to locate Teleport target with selector "#teleport-header-left". Note the target element must exist before the component is mounted - i.e. the target cannot be rendered by the component itself, and ideally should be outside of the entire Vue component tree. 
js 复制代码
[Vue warn]: Invalid Teleport target on mount: null (object) 

大概就是需要空投的节点'#teleport-header-left',还没渲染,或不存在,Teleport就已经开始投送了。

解决的办法:

引入defineAsyncComponent,将含有Teleport的文件懒加载。

js 复制代码
import { defineAsyncComponent } from "vue";

const TeleportCom = definAsyncComponent(() => import('....'));

同一个组件内由上到下渲染,只要to的目标渲染了,就可以挂到对应的节点上。

还可以结合v-bind进行动态渲染到某个节点上去

js 复制代码
<Teleport :to="targetRef">
    <div>把我挂载<div>
</Teleport>

//js
const props = defineProps({
    targetRef: {
        type: String,
        default: 'body',
    }
})

禁用Teleport,场景:客户端需要空投,移动端不需要。

js 复制代码
<Teleport :disabled="isMobile">
  ...
</Teleport>

多个Teleport共享目标,挂载到同一个id上,那么会有先后顺序,也就是追加在后面渲染

js 复制代码
<Teleport to="#modals">
  <div>A</div>
</Teleport>
<Teleport to="#modals">
  <div>B</div>
</Teleport>
相关推荐
明月_清风22 分钟前
自定义右键菜单:在项目里实现“选中文字即刻生成新提示”
前端·javascript
明月_清风23 分钟前
告别后端转换:高质量批量导出实战
前端·javascript
刘发财5 小时前
弃用html2pdf.js,这个html转pdf方案能力是它的几十倍
前端·javascript·github
牛奶7 小时前
2026年大模型怎么选?前端人实用对比
前端·人工智能·ai编程
牛奶7 小时前
前端人为什么要学AI?
前端·人工智能·ai编程
Kagol10 小时前
🎉OpenTiny NEXT-SDK 重磅发布:四步把你的前端应用变成智能应用!
前端·开源·agent
GIS之路11 小时前
ArcGIS Pro 中的 notebook 初识
前端
JavaGuide11 小时前
7 道 RAG 基础概念知识点/面试题总结
前端·后端
ssshooter12 小时前
看完就懂 useSyncExternalStore
前端·javascript·react.js
格砸12 小时前
从入门到辞职|从ChatGPT到OpenClaw,跟上智能时代的进化
前端·人工智能·后端