百科狗-知识改变命运!
--

Teleport 传送模板 - vue 内置组件

乐乐1年前 (2023-11-21)阅读数 21#技术干货
文章标签组件

Teleport 传送模板

是一个内置组件,使我们可以将一个组件的一部分模板“传送”到该组件的 DOM 层次结构之外的 DOM 节点中。

基本使用

有时我们可能会遇到以下情况:组件模板的一部分在逻辑上属于它,但从整个应用视图的角度来看,在 DOM 中它应该显示在 Vue 应用之外的其他地方。

最常见的例子是想要一个全屏的模态框时。理想情况下,我们希望模态框的按钮和模态框本身是在同一个组件中,因为它们都与组件的开关状态有关。但这意味着该模态框将与按钮一起渲染在应用 DOM 结构里很深的地方。这会导致该模态框的 CSS 布局代码很难写。

试想下面这样的 HTML 结构:

Tooltips with Vue 3 Teleport

接下来我们来看看MyModal的实现。

// MyModal.vue



  Open Modal 

Hello from the modal!

Close
.modal { position: fixed; z-index: 999; top: 20%; left: 50%; width: 300px; margin-left: -150px; }

这个组件中有一个按钮来触发打开模态框,和一个 css 类名为.modal的

,它包含了模态框的内容和一个用来关闭的按钮。

当在初始 HTML 结构中使用这个组件时,会有一些潜在的问题:

  • position: fixed能够相对于视口放置的条件是:没有任何祖先元素设置了transformperspective或者filter样式属性。而如果我们想要用 CSS transform为祖先节点
    设置动画,则会破坏模态框的布局结构!
  • 这个模态框的z-index被包含它的元素所制约。如果有其他元素与
    重叠并有更高的z-index,则它会覆盖住我们的模态框。


    提供了一个更简洁的方式来解决此类问题,使我们无需考虑那么多层 DOM 结构的问题。让我们用改写一下

    Open Modal 

    接收一个to prop 来指定传送的目标。其值可以是一个 CSS 选择器字符串或者一个真实的DOM 节点。这里我们其实就是让 Vue 去“传送这部分模板片段到body标签下”。

    Teleport 传送模板 - vue 内置组件

    你可以将结合使用来创建一个带动画的模态框。

    挂载时,传送门的to目标必须是已经存在于 DOM 之中。理想情况下,这应该是整个 Vue 应用 DOM 树外部的一个元素。如果目标元素也是由 Vue 渲染的,你需要确保在挂载在之前挂载该元素。


    搭配组件使用

    只改变了渲染的 DOM 结构,它不会影响组件间的逻辑关系。这也就是说,如果包含了一个组件,那么该组件始终和这个使用了的组件保持逻辑上的父子关系。传入的props和触发的事件也会照常工作。

    这也意味着来自父组件的注入也会按预期工作,子组件将在 Vue Devtools 中嵌套在父级组件下面,而不是放在实际内容移动到的地方。


    禁用传送门

    在某些场景中,你们可能需要视情况禁用。举个例子,我们想要在桌面端将一个组件当做浮层来渲染,但在移动端则当作行内组件。可以对动态地传入一个disabled prop 来处理这两种不同情况。

     ... 

    这里的isMobile状态可以根据 CSS media query 不同结果动态地更新。


    同一目标上多个传送门

    一个可重用的模态框组件可能同时存在多个实例。对于此类场景,多个组件可以将其内容挂载在同一个目标元素上,而顺序就是简单的顺次追加,后挂载的将排在目标元素下更后面的位置上。

    我们给出下面这样的用例:

     
    A
    B

    渲染的结果为:

    A
    B

鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com

免责声明:我们致力于保护作者版权,注重分享,当前被刊用文章因无法核实真实出处,未能及时与作者取得联系,或有版权异议的,请联系管理员,我们会立即处理! 部分文章是来自自研大数据AI进行生成,内容摘自(百度百科,百度知道,头条百科,中国民法典,刑法,牛津词典,新华词典,汉语词典,国家院校,科普平台)等数据,内容仅供学习参考,不准确地方联系删除处理!邮箱:344225443@qq.com)

图片声明:本站部分配图来自网络。本站只作为美观性配图使用,无任何非法侵犯第三方意图,一切解释权归图片著作权方,本站不承担任何责任。如有恶意碰瓷者,必当奉陪到底严惩不贷!

内容声明:本文中引用的各种信息及资料(包括但不限于文字、数据、图表及超链接等)均来源于该信息及资料的相关主体(包括但不限于公司、媒体、协会等机构)的官方网站或公开发表的信息。部分内容参考包括:(百度百科,百度知道,头条百科,中国民法典,刑法,牛津词典,新华词典,汉语词典,国家院校,科普平台)等数据,内容仅供参考使用,不准确地方联系删除处理!本站为非盈利性质站点,本着为中国教育事业出一份力,发布内容不收取任何费用也不接任何广告!)
最新文章
标签列表