mirror of
https://github.com/nuxt/nuxt.git
synced 2024-11-26 23:52:06 +00:00
f26a801775
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> Co-authored-by: Daniel Roe <daniel@roe.dev>
41 lines
970 B
Markdown
41 lines
970 B
Markdown
---
|
|
title: '<Teleport>'
|
|
description: The <Teleport> component teleports a component to a different location in the DOM.
|
|
---
|
|
|
|
::callout{color="amber" icon="i-ph-warning-duotone"}
|
|
The `to` target of [`<Teleport>`](https://vuejs.org/guide/built-ins/teleport.html) expects a CSS selector string or an actual DOM node. Nuxt currently has SSR support for teleports to `body` only, with client-side support for other targets using a `<ClientOnly>` wrapper.
|
|
::
|
|
|
|
## Body Teleport
|
|
|
|
```vue
|
|
<template>
|
|
<button @click="open = true">
|
|
Open Modal
|
|
</button>
|
|
<Teleport to="body">
|
|
<div v-if="open" class="modal">
|
|
<p>Hello from the modal!</p>
|
|
<button @click="open = false">
|
|
Close
|
|
</button>
|
|
</div>
|
|
</Teleport>
|
|
</template>
|
|
```
|
|
|
|
## Client-side Teleport
|
|
|
|
```vue
|
|
<template>
|
|
<ClientOnly>
|
|
<Teleport to="#some-selector">
|
|
<!-- content -->
|
|
</Teleport>
|
|
</ClientOnly>
|
|
</template>
|
|
```
|
|
|
|
:link-example{to="/docs/examples/advanced/teleport"}
|