一文讲解vue3的Teleport和Suspense
- 一、👋用teleport实现打开模态框操作
- 1、teleport是什么
- 2、实现模态框功能
- （1）设置锚点
- （2）定义子组件
- （3）定义父组件
- 二、🤚用Suspense
- 1、Suspense是什么
- 2、用Suspense发起一个异步请求
- 3、用Suspense发起多个异步请求
- 4、如何抓取错误
- 三、🖐️结束语
大家都知道，在我们平常的前端开发中，实现模态框和发起异步请求是再常见不过的事情了。但是呢，不管是用vue2和原生js的实现方式，从逻辑上来说都还不够独立，因此，vue3推出了新的方法来解决此问题。
下面就带领大家一起来了解vue3新推出的 teleport 究竟有多神奇？以及如何用 suspense 发起多个异步的请求？
一起来学习吧~📚
一、👋用teleport实现打开模态框操作
1、teleport是什么
teleport，字面意思就是远距离传送，我们可以把它理解为传送门的意思。
大家都知道，传送门的意思就是从一个地方传送到了另外一个地方。而 vue3 为什么要用 teleport 来表达呢？
其实，有一个非常常见的需求就是，我们经常要通过点击一个按钮，来实现模态框的效果。而在 vue3 之前，我们基本上控制它都是点击后上下会形成一个父子组件的关系，这样子感觉独立性就没有那么强了。
因此， vue3 为了解决该问题，就用了 teleport 来解决。 teleport 就仿佛一个传送门，像上图这样，比如我们点击了打开按钮，那么点击完了之后，使用传送门瞬间移动到另外一个地方（模态框 Model ）。再点击关闭按钮，传送门模态框 Modal 就消失了。
通过这样的解释，相信大家对 teleport 有了一个基础的认识。
2、实现模态框功能
接下来我们就来用这个功能，实现一个模态框，控制组件的显示和隐藏。
（1）设置锚点
我们现在 vue3 项目下的 /public/index.html 设置一个锚点，来放置组件的内容。具体代码如下：
<body><noscript><strong>We're sorry but <%= htmlWebpackPlugin.options.title %> doesn't work properly without JavaScript enabled. Please enable it to continue.</strong></noscript><div id="app"></div>//先行定义一个锚点<div id="modal"></div><!-- built files will be auto injected --></body>
（2）定义子组件
接下来我们在 /src/components 下定义一个子组件，命名为 Modal.vue 。具体代码如下：
<template><teleport to="#modal"><div id="center" v-if="isOpen"><h2><slot>this is a modal</slot></h2><button class="btn2" @click="buttonClick">Close</button></div></teleport>
</template><script>
import { defineComponent } from 'vue'
export default defineComponent({//父组件的数据需要通过props把数据传给子组件，props的取值可以是数组也可以是对象props: {isOpen: Boolean,},//子组件向父组件传递数据//使用emits，更明确的显示组件的自定义事件有哪些emits: {'close-modal': null},//props对应props的内容//context名字可以自定义，只要上下对应即可，用来触发emit的内容setup(props, context){const buttonClick = () => {context.emit('close-modal')}return{buttonClick}}
})
</script><style>
#center{width:200px;height:200px;border:2px solid rgb(105, 165, 56);text-align: center;border-radius: 2px;margin: 50px auto 0;
}
.btn2{background: #1971c9;border:none;padding: 8px;border-radius: 5px;color: #fff;cursor: pointer;
}
</style>
（3）定义父组件
之后我们再来定义一个父组件，命名为 index.vue 。具体代码如下：
<template><button class="btn1" @click="openModal">打开模态框</button><modal :isOpen="modalIsOpen" @close-modal="onModalClose">My Modal!!!</modal>
</template><script lang="ts">
import { ref, defineComponent} from 'vue'
import Modal from './components/Modal.vue'export default defineComponent({name: 'App',components: {Modal},setup(){//添加响应式对象控制是否显示const modalIsOpen = ref(false)//打开模态框事件const openModal = () => {modalIsOpen.value = true}//关闭模态框事件const onModalClose = () => {modalIsOpen.value = false}return{modalIsOpen,openModal,onModalClose}}
});
</script><style>
#app {font-family: Avenir, Helvetica, Arial, sans-serif;-webkit-font-smoothing: antialiased;-moz-osx-font-smoothing: grayscale;text-align: center;color: #2d4c6b;margin-top: 60px;
}
.btn1{background: #1971c9;border:none;padding: 16px;border-radius: 5px;color: #fff;cursor: pointer;
}
</style>现在我们来看下浏览器的显示效果：
大家可以看到，通过 teleport 的方式，现在的模态框成功显示在 id 为 app 的 div 同一层下，达到了相互独立，而不再是父子层级的结果。
在上面的案例中，我们学习到了通过使用 vue3 新推出的 teleport 特性，将组件渲染到另外一个 DOM 节点的方法，这样使得组件之间的独立性更强。
二、🤚用Suspense
1、Suspense是什么
我们都知道，在 web 世界中，经常遇到很多的异步请求困境。在发起异步请求时，我们往往需要去判断这些异步请求的状态，然后呢，根据这些请求来展示不同的界面。
那现在呢， vue3 推出了一个新的内置组件 Suspense ， Suspense 是一个特殊的组件，它会有两个 template slot ，刚开始会渲染 feedback 内容，直到达到某个条件以后，才会渲染正式的内容，也就是default的内容。这样呢，进行异步内容的渲染就会变得特别简单。
同时值得注意的是，如果使用 Suspense ，要返回一个 promise 而不是一个对象。
2、用Suspense发起一个异步请求
接下来我们使用 Suspense 来发起一个异步请求。
首先我们在项目下定义一个子组件，命名为 AsyncShow.vue ，具体代码如下：
<template><h1>{{result}}</h1>
</template>
<script lang="ts">
import { defineComponent } from 'vue'
export default defineComponent({setup() {//使用Suspense需要返回一个对象return new Promise((resolve) => {setTimeout(() => {return resolve({result: '10000'})}, 3000)})}
})
</script>之后在项目下再定义一个父组件，命名为 DogShow.vue ，具体代码如下：
<template><div id="app"><Suspense><template #default><async-show /></template><template #fallback><h1>Loading !...</h1></template></Suspense></div>
</template><script lang="ts">
import { defineComponent } from 'vue'
import AsyncShow from './components/AsyncShow.vue'export default defineComponent({name: 'App',components: {AsyncShow,},setup() {}
});
</script><style>
#app {font-family: Avenir, Helvetica, Arial, sans-serif;-webkit-font-smoothing: antialiased;-moz-osx-font-smoothing: grayscale;text-align: center;color: #2c3e50;margin-top: 60px;
}
h1 {font-size: 6rem;
}
</style>最终浏览器的显示效果如下：
大家可以看到，通过 Suspense ，可以很轻易的发起一个异步请求。刚开始是fallback状态，之后达到 3s 的时间之后，切换到default的状态，显示出对应的异步请求内容。
3、用Suspense发起多个异步请求
我们不满足于现状，且互联网千奇百怪的，我们总不能一直只发送一个异步请求吧！所以，接下来我们就来实现发起多个异步请求的效果。
首先我们用一个免费的在线API ，来发起一个请求。接下来我们在项目的 components 文件下，再定义一个子组件，命名为 DogShow.vue ，具体代码如下：
<template><img :src="result && result.message">
</template>
<script lang="ts">
import axios from 'axios'
import { defineComponent } from 'vue'
export default defineComponent({async setup() {const rawData = await axios.get('https://dog.ceo/api/breeds/image/random')return {result: rawData.data}}
})
</script>
接下来我们再把以上子组件的内容添加到父组件中，具体代码如下：
<template><div id="app"><Suspense><template #default><async-show /><dog-show /><template #fallback><h1>Loading !...</h1></template></Suspense></div>
</template><script lang="ts">
import AsyncShow from './components/AsyncShow.vue'
import DogShow from './components/DogShow.vue'export default {name: 'App',components: {AsyncShow,DogShow},setup() {}
};
</script><style>
#app {font-family: Avenir, Helvetica, Arial, sans-serif;-webkit-font-smoothing: antialiased;-moz-osx-font-smoothing: grayscale;text-align: center;color: #2c3e50;margin-top: 60px;
}
h1 {font-size: 6rem;
}
</style>
最终浏览器的显示效果如下：
大家可以看到，我们同时发起了两个异步请求，并且在Suspense中的default插槽里面同时使用。同样的，浏览器会先显示fallback的内容，之后等到时机到了，就显示我们请求的内容。
依据这样的例子，显示更多的请求也同样有效。这样对比起来，发送多个异步请求是不是就方便了许多。
4、如何抓取错误
学完上面的内容，相信大家对Suspense的用法已经有所了解。那么，网络请求千奇百怪的，总不能每次都能够很顺畅的发起请求对吧。所以呢，我们来需要再来学习一下，当网络请求失败时，如何抓取Supsense包裹下的错误。
这个时候我们可以使用一个钩子函数，这个函数叫做 onErrorCaptured ，接下来我们来看下怎么抓取。
我们将父组件 index.vue 进行改造，具体代码如下：
<template><div id="app"><p>{{error}}</p><Suspense><template #default><async-show /><dog-show /><template #fallback><h1>Loading !...</h1></template></Suspense></div>
</template><script lang="ts">
import { onErrorCaptured } from 'vue'
import AsyncShow from './components/AsyncShow.vue'
import DogShow from './components/DogShow.vue'export default {name: 'App',components: {AsyncShow,DogShow},setup() {const error = ref(null)onErrorCaptured((e: any) => {error.value = ereturn true})return{error}}
};
</script><style>
#app {font-family: Avenir, Helvetica, Arial, sans-serif;-webkit-font-smoothing: antialiased;-moz-osx-font-smoothing: grayscale;text-align: center;color: #2c3e50;margin-top: 60px;
}
h1 {font-size: 6rem;
}
</style>
此时我们再将 DogShow.vue 的接口进行修改，让其变成一个无效的API。代码如下：
const rawData = await axios.get('https://dog.ceo/api/breeds/image')
接下来我们就来看一下浏览器的运行效果：
大家可以看到，修改成无效的 API 后，狗狗的图片也不显示了，最后最上方就是通过 onErrorCaptured 这个生命周期捕捉到的错误，清晰明了。
三、🖐️结束语
到这里， teleport 和 Suspense 的内容就讲解结束啦！相信大家对传送门的神奇之处也有了一定的了解，对 Suspense 的独到之处也感受了一番。
vue3持续学习，更新永不停歇……
- 关注公众号 星期一研究室 ，第一时间关注学习干货，更多有趣的专栏待你解锁~
- 如果这篇文章对你有用，记得 一键三连 再走哦~
- 我们下期见！🥂🥂🥂
