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>
47 lines
1.1 KiB
Markdown
47 lines
1.1 KiB
Markdown
---
|
|
title: '<ClientOnly>'
|
|
description: Render components only in client-side with the <ClientOnly> component.
|
|
links:
|
|
- label: Source
|
|
icon: i-simple-icons-github
|
|
to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/components/client-only.ts
|
|
size: xs
|
|
---
|
|
|
|
The `<ClientOnly>` component renders its slot only in client-side. To import a component only on the client, register the component in a client-side only plugin.
|
|
|
|
## Props
|
|
|
|
- `placeholderTag` | `fallbackTag`: specify a tag to be rendered server-side.
|
|
- `placeholder` | `fallback`: specify a content to be rendered server-side.
|
|
|
|
```vue
|
|
<template>
|
|
<div>
|
|
<Sidebar />
|
|
<ClientOnly fallback-tag="span" fallback="Loading comments...">
|
|
<Comment />
|
|
</ClientOnly>
|
|
</div>
|
|
</template>
|
|
```
|
|
|
|
## Slots
|
|
|
|
- `#fallback`: specify a content to be displayed server-side.
|
|
|
|
```vue
|
|
<template>
|
|
<div>
|
|
<Sidebar />
|
|
<ClientOnly>
|
|
<!-- ... -->
|
|
<template #fallback>
|
|
<!-- this will be rendered on server side -->
|
|
<p>Loading comments...</p>
|
|
</template>
|
|
</ClientOnly>
|
|
</div>
|
|
</template>
|
|
```
|