<ClientOnly>
使用 <ClientOnly> 组件仅在客户端渲染组件。
<ClientOnly>
组件用于仅在客户端渲染组件。
默认插槽的内容将在服务器构建中被 tree-shaken 掉。(这意味着其中组件使用的任何 CSS 在渲染初始 HTML 时可能不会被内联。)
Props
placeholderTag
|fallbackTag
: 指定一个在服务器端渲染的标签。placeholder
|fallback
: 指定一个在服务器端渲染的内容。
<template>
<div>
<Sidebar />
<!-- <Comment> 组件将仅在客户端渲染 -->
<ClientOnly fallback-tag="span" fallback="Loading comments...">
<Comment />
</ClientOnly>
</div>
</template>
Slots
#fallback
: 指定一个在服务器上渲染的内容,并在<ClientOnly>
在浏览器中挂载之前显示。
pages/example.vue
<template>
<div>
<Sidebar />
<!-- 这将在服务器端渲染 "span" 元素 -->
<ClientOnly fallbackTag="span">
<!-- 这个组件将仅在客户端渲染 -->
<Comments />
<template #fallback>
<!-- 这将在服务器端渲染 -->
<p>Loading comments...</p>
</template>
</ClientOnly>
</div>
</template>
Examples
访问 HTML 元素
<ClientOnly>
内的组件仅在挂载后渲染。要访问 DOM 中渲染的元素,可以监视一个模板引用:
pages/example.vue
<script setup lang="ts">
const nuxtWelcomeRef = useTemplateRef('nuxtWelcomeRef')
// 当组件可用时,监视器将被触发
watch(nuxtWelcomeRef, () => {
console.log('<NuxtWelcome /> mounted')
}, { once: true })
</script>
<template>
<ClientOnly>
<NuxtWelcome ref="nuxtWelcomeRef" />
</ClientOnly>
</template>