---
title: "<Teleport>"
description: "<Teleport> 组件会将组件传送到 DOM 的其他位置。"
canonical_url: "https://nuxt.zhcndoc.com/docs/4.x/api/components/teleports"
---
# \<Teleport>

> \<Teleport> 组件会将组件传送到 DOM 的其他位置。

::warning
[`<Teleport>`](https://vue.zhcndoc.com/guide/built-ins/teleport) 的 `to` 目标期望一个 CSS 选择器字符串或一个实际的 DOM 节点。Nuxt 目前仅对传送到 `#teleports` 的情况提供 SSR 支持，其他目标的客户端支持需使用 `<ClientOnly>` 包裹。
::

## 页面主体传送

```vue
<template>
  <button @click="open = true">
    打开模态框
  </button>
  <Teleport to="#teleports">
    <div
      v-if="open"
      class="modal"
    >
      <p>来自模态框的问候！</p>
      <button @click="open = false">
        关闭
      </button>
    </div>
  </Teleport>
</template>
```

## 客户端传送

```vue
<template>
  <ClientOnly>
    <Teleport to="#some-selector">
      <!-- 内容 -->
    </Teleport>
  </ClientOnly>
</template>
```

::link-example{to="https://nuxt.zhcndoc.com/docs/examples/advanced/teleport"}
::


## Sitemap

See the full [sitemap](https://nuxt.zhcndoc.com/sitemap.md) for all pages.