官方文檔
視頻教程
似曾相識？
沒錯就是它！
詳細的 teleport 使用步驟
1. 定義要瞬移的內容
使用 <teleport></teleport> 標簽包裹內容，且給 to 屬性綁定瞬移位置的選擇器。
/src/components/HelloWorld.vue：
<template>
<div class="hello">
<div>Hello World</div>
<teleport to="#modal">
<h1>Hello Modal</h1>
</teleport>
</div>
</template>
<script lang="ts">
import { defineComponent } from "vue";
export default defineComponent({
name: "HelloWorld",
props: {
msg: String
}
});
</script>
<!-- Add "scoped" attribute to limit CSS to this component only -->
<style scoped>
.hello {
margin: 40px 0 0;
color: #42b983;
}
</style>
2. 引入 HelloWorld 組件，且設定要瞬移后的位置
/src/App.vue
<template>
<div id="app">
<h1>{{ count }}</h1>
<button @click="plus">plus</button>
<br />
<HelloWorld />
<div
id="modal"
style="border: 1px solid #42b983; padding: 20px; margin: 20px 0"
></div>
</div>
</template>
<script lang="ts">
import { ref } from "vue";
import HelloWorld from "./components/HelloWorld.vue";
export default {
name: "App",
components: {
HelloWorld
},
setup() {
const count = ref(0);
function plus() {
count.value++;
}
return {
count,
plus
};
}
};
</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;
}
</style>
3. 這時候可以看到控制臺有warning
建議將要瞬移后的位置移動到整個 vue 組件樹的外面
4. 將瞬移后的位置改為在 index.html 里
/public/index.html
<!DOCTYPE html>
<html lang="">
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width,initial-scale=1.0" />
<link rel="icon" href="<%= BASE_URL %>favicon.ico" />
<title><%= htmlWebpackPlugin.options.title %></title>
</head>
<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>
<!-- #modal 放在 #app 后 -->
<div
id="modal"
style="border: 1px solid #42b983; padding: 20px; margin: 20px 0"
></div>
<!-- built files will be auto injected -->
</body>
</html>
5. 能正常顯示了
6. 加入數據交互
假設就為一個 Modal ：
- 默認為不渲染狀態。
- 在
HelloWorld組件里有一個按鈕，點擊能渲染顯示Modal -
Modal內部有一個按鈕，點擊能關閉Modal
<template>
<div class="hello">
<div>Hello World</div>
<!-- 在 HelloWorld 組件里有一個按鈕，點擊能渲染顯示 Modal -->
<button @click="showModal = true">open modal</button>
<teleport to="#modal">
<!-- showModal 狀態來控制是否顯示 Modal 內容 -->
<template v-if="showModal">
<h1>Hello Modal</h1>
<!-- Modal 內部有一個按鈕，點擊能關閉 Modal -->
<button @click="showModal = false">close</button>
</template>
</teleport>
</div>
</template>
<script lang="ts">
import { defineComponent, ref } from "vue";
export default defineComponent({
name: "HelloWorld",
props: {
msg: String
},
setup() {
// showModal 狀態來控制是否顯示 Modal 內容
const showModal = ref(false);
return {
showModal
};
}
});
</script>
<!-- Add "scoped" attribute to limit CSS to this component only -->
<style scoped>
.hello {
margin: 40px 0 0;
color: #42b983;
}
</style>
完美
可以觀察到：
雖然我們是在 HelloWorld.vue 組件里定義 <teleport to="#modal"></teleport> 內容的，但它實際渲染的位置在 #modal 處，完成了“瞬間移動”。
teleport 上還有一個屬性 disabled
設置為 true ：
<template>
<div class="hello">
<div>Hello World</div>
<!-- 在 HelloWorld 組件里有一個按鈕，點擊能渲染顯示 Modal -->
<button @click="showModal = true">open modal</button>
<teleport to="#modal" :disabled="true">
<!-- showModal 狀態來控制是否顯示 Modal 內容 -->
<template v-if="showModal">
<h1>Hello Modal</h1>
<!-- Modal 內部有一個按鈕，點擊能關閉 Modal -->
<button @click="showModal = false">close</button>
</template>
</teleport>
</div>
</template>
<script lang="ts">
import { defineComponent, ref } from "vue";
export default defineComponent({
name: "HelloWorld",
props: {
msg: String
},
setup() {
// showModal 狀態來控制是否顯示 Modal 內容
const showModal = ref(false);
return {
showModal
};
}
});
</script>
<!-- Add "scoped" attribute to limit CSS to this component only -->
<style scoped>
.hello {
margin: 40px 0 0;
color: #42b983;
}
</style>
查看頁面會發現：彈窗內容不在 #modal 即綠色框里
查看 DOM 結構：
渲染在 HelloWorld.vue 組件里了
