feat(teleport): support deferred Teleport

[yyx990803]

close #2015
close #11386

This pull request introduces a new prop for the built-in Teleport component: defer.

A deferred Teleport will wait until all other DOM content in the same update cycle has been rendered before locating the target container and mounting its children, so this is now possible:

<Teleport defer to="#target">...</Teleport>
<div id="target"></div>

Even if <div#target> appears after <Teleport>, it can still be resolved. This also works even if <div#target> is rendered by other components, as long as they are mounted in the same tick with the component containing the <Teleport>.

Usage with Suspense

Another use case for defer is inside <Suspense>. Previously, <Teleport> inside <Suspense> will eagerly resolve its target and therefore can only target containers outside of the <Suspense>. With defer, the target resolution happens when the Suspense is resolved, after resolved content is inserted into the DOM:

<Suspense>
  <div>
    <AsyncComp />
    <Teleport defer to="#target">...</Teleport>
    <div id="target"></div>
  </div>
</Suspense>

Implications of Defer Mode

This behavior is only enabled via the defer prop because it can lead to different lifecycle call order compared to the default behavior. For example, mounted hooks of components inside a deferred Teleport tree will be called after the mounted hooks of the parent. The behavior of deferred vs. non-deferred Teleports are also completely different when placed inside <Suspense>.

[yyx990803]

/ecosystem-ci run

[github-actions]

Size Report

Bundles

File	Size	Gzip	Brotli
runtime-dom.global.prod.js	93.7 kB (+3.68 kB)	35.6 kB (+1.15 kB)	32.1 kB (+1.06 kB)
vue.global.prod.js	151 kB (+4.64 kB)	55.4 kB (+1.38 kB)	49.2 kB (+1.2 kB)

Usages

Name	Size	Gzip	Brotli
createApp	53.1 kB (+3.31 kB)	20.6 kB (+1.02 kB)	18.7 kB (+903 B)
createSSRApp	56.7 kB (+3.31 kB)	22 kB (+987 B)	20.1 kB (+946 B)
defineCustomElement	55.4 kB (+3.31 kB)	21.3 kB (+1.06 kB)	19.4 kB (+915 B)
overall	66.7 kB (+3.37 kB)	25.6 kB (+1.04 kB)	23.2 kB (+951 B)

[vue-bot]

📝 Ran ecosystem CI: Open

suite	result	latest scheduled
language-tools	❌ failure	❌ failure
nuxt	❌ failure	✅ success
pinia	✅ success	✅ success
primevue	✅ success	✅ success
quasar	✅ success	✅ success
radix-vue	✅ success	✅ success
router	✅ success	✅ success
test-utils	✅ success	✅ success
vant	❌ failure	✅ success
vite-plugin-vue	✅ success	✅ success
vitepress	❌ failure	✅ success
vue-i18n	❌ failure	❌ failure
vue-macros	❌ failure	✅ success
vuetify	✅ success	❌ failure
vueuse	✅ success	✅ success
vue-simple-compiler	✅ success	✅ success