<ClientOnly>

仅在客户端渲染组件,使用 <ClientOnly> 组件。

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

默认插槽的内容将在服务器构建中被树摇(这意味着用于组件的任何 CSS 可能在渲染初始 HTML 时不会被内联)

属性

  • placeholderTag | fallbackTag: 指定一个标签以在服务器端渲染。
  • placeholder | fallback: 指定一个内容以在服务器端渲染。
<template>
  <div>
    <Sidebar />
    <!-- Comment 组件将仅在客户端渲染 -->
    <ClientOnly fallback-tag="span" fallback="Loading comments...">
      <Comment />
    </ClientOnly>
  </div>
</template>

插槽

  • #fallback: 指定一个内容以在服务器上渲染,直到 在浏览器中挂载。
pages/example.vue
<template>
  <div>
    <Sidebar />
    <!-- 这将渲染服务器端的 "span" 元素 -->
    <ClientOnly fallbackTag="span">
      <!-- 这个组件将仅在客户端渲染 -->
      <Comments />
      <template #fallback>
        <!-- 这将在服务器端渲染 -->
        <p>Loading comments...</p>
      </template>
    </ClientOnly>
  </div>
</template>

示例

访问 HTML 元素

<ClientOnly> 内部的组件仅在挂载后渲染。要访问 DOM 中渲染的元素,可以观察一个模板引用:

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

// The watch will be triggered when the component is available
watch(nuxtWelcomeRef, () => {
 console.log('<NuxtWelcome /> mounted')
}, { once: true })
</script>

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