feat: 위키 저장소 초기 커밋
- CLAUDE.md 운영 규칙 - wiki/ 정리된 지식 페이지 (Nuxt + Claude Code) - raw/ 원본 자료 - reference/ Nuxt 4.x 공식 문서 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
96
reference/4.api/2.composables/use-lazy-async-data.md
Normal file
96
reference/4.api/2.composables/use-lazy-async-data.md
Normal file
@@ -0,0 +1,96 @@
|
||||
---
|
||||
title: useLazyAsyncData
|
||||
description: This wrapper around useAsyncData triggers navigation immediately.
|
||||
links:
|
||||
- label: Source
|
||||
icon: i-simple-icons-github
|
||||
to: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/app/composables/asyncData.ts
|
||||
size: xs
|
||||
---
|
||||
|
||||
`useLazyAsyncData` provides a wrapper around [`useAsyncData`](/docs/4.x/api/composables/use-async-data) that triggers navigation before the handler is resolved by setting the `lazy` option to `true`.
|
||||
|
||||
::note
|
||||
By default, [`useAsyncData`](/docs/4.x/api/composables/use-async-data) blocks navigation until its async handler is resolved. `useLazyAsyncData` allows navigation to occur immediately while data fetching continues in the background.
|
||||
::
|
||||
|
||||
## Usage
|
||||
|
||||
```vue [app/pages/index.vue]
|
||||
<script setup lang="ts">
|
||||
const { status, data: posts } = await useLazyAsyncData('posts', () => $fetch('/api/posts'))
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div>
|
||||
<div v-if="status === 'pending'">
|
||||
Loading...
|
||||
</div>
|
||||
<div v-else-if="status === 'error'">
|
||||
Error loading posts
|
||||
</div>
|
||||
<div v-else>
|
||||
{{ posts }}
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
```
|
||||
|
||||
When using `useLazyAsyncData`, navigation will occur before fetching is complete. This means you must handle `pending` and `error` states directly within your component's template.
|
||||
|
||||
::warning
|
||||
`useLazyAsyncData` is a reserved function name transformed by the compiler, so you should not name your own function `useLazyAsyncData`.
|
||||
::
|
||||
|
||||
## Type
|
||||
|
||||
```ts [Signature]
|
||||
export function useLazyAsyncData<DataT, ErrorT> (
|
||||
handler: (ctx?: NuxtApp) => Promise<DataT>,
|
||||
options?: AsyncDataOptions<DataT>,
|
||||
): AsyncData<DataT, ErrorT>
|
||||
|
||||
export function useLazyAsyncData<DataT, ErrorT> (
|
||||
key: string,
|
||||
handler: (ctx?: NuxtApp) => Promise<DataT>,
|
||||
options?: AsyncDataOptions<DataT>,
|
||||
): AsyncData<DataT, ErrorT>
|
||||
```
|
||||
|
||||
`useLazyAsyncData` has the same signature as [`useAsyncData`](/docs/4.x/api/composables/use-async-data).
|
||||
|
||||
## Parameters
|
||||
|
||||
`useLazyAsyncData` accepts the same parameters as [`useAsyncData`](/docs/4.x/api/composables/use-async-data), with the `lazy` option automatically set to `true`.
|
||||
|
||||
:read-more{to="/docs/4.x/api/composables/use-async-data#parameters"}
|
||||
|
||||
## Return Values
|
||||
|
||||
`useLazyAsyncData` returns the same values as [`useAsyncData`](/docs/4.x/api/composables/use-async-data).
|
||||
|
||||
:read-more{to="/docs/4.x/api/composables/use-async-data#return-values"}
|
||||
|
||||
## Example
|
||||
|
||||
```vue [app/pages/index.vue]
|
||||
<script setup lang="ts">
|
||||
/* Navigation will occur before fetching is complete.
|
||||
Handle 'pending' and 'error' states directly within your component's template
|
||||
*/
|
||||
const { status, data: count } = await useLazyAsyncData('count', () => $fetch('/api/count'))
|
||||
|
||||
watch(count, (newCount) => {
|
||||
// Because count might start out null, you won't have access
|
||||
// to its contents immediately, but you can watch it.
|
||||
})
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div>
|
||||
{{ status === 'pending' ? 'Loading' : count }}
|
||||
</div>
|
||||
</template>
|
||||
```
|
||||
|
||||
:read-more{to="/docs/4.x/getting-started/data-fetching"}
|
||||
Reference in New Issue
Block a user