v3.16
Nuxt on GitHub

<ClientOnly>

源代码
使用 <ClientOnly> 组件仅在客户端渲染组件。

<ClientOnly> 组件用于专门在客户端渲染组件。

默认插槽的内容将在服务器构建中被移除（这意味着其中组件使用的任何 CSS 可能不会在渲染初始 HTML 时内联）。

属性

  • placeholderTag | fallbackTag：指定在服务器端渲染的标签。
  • placeholder | fallback：指定在服务器端渲染的内容。
<template>
  <div>
    <Sidebar />
    <!-- <Comment> 组件仅在客户端渲染 -->
    <ClientOnly fallback-tag="span" fallback="正在加载评论...">
      <Comment />
    </ClientOnly>
  </div>
</template>

插槽

  • #fallback：指定在服务器端渲染并在浏览器中 <ClientOnly> 挂载前显示的内容。
pages/example.vue
<template>
  <div>
    <Sidebar />
    <!-- 在服务器端渲染为 "span" 元素 -->
    <ClientOnly fallbackTag="span">
      <!-- 此组件仅在客户端渲染 -->
      <Comments />
      <template #fallback>
        <!-- 这将在服务器端渲染 -->
        <p>正在加载评论...</p>
      </template>
    </ClientOnly>
  </div>
</template>

示例

访问 HTML 元素

<ClientOnly> 内的组件仅在挂载后渲染。要访问 DOM 中的渲染元素，您可以监听模板引用：

pages/example.vue
<script setup lang="ts">
const nuxtWelcomeRef = useTemplateRef('nuxtWelcomeRef')

// 当组件可用时，监听将被触发
watch(nuxtWelcomeRef, () => {
 console.log('<NuxtWelcome /> 已挂载')
}, { once: true })
</script>

<template>
  <ClientOnly>
    <NuxtWelcome ref="nuxtWelcomeRef" />
  </ClientOnly>
</template>