Vue Suspense 컴포넌트
기본 및 #fallback 슬롯을 사용하는 , 비동기 컴포넌트 로딩과 중첩 Suspense를 다룹니다.
Vue Suspense 컴포넌트은(는) CoddyKit의 무료 Vue Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Vue Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
Suspense가 해결하는 문제
Suspense는 비동기 종속성이 있는 컴포넌트의 로딩 상태를 조정하는 Vue 내장 컴포넌트입니다.
Suspense가 없으면 모든 비동기 컴포넌트가 자체 로딩 표시를 관리해야 합니다. Suspense를 사용하면 중첩된 모든 비동기 작업이 완료될 때까지 기다리는 하나의 경계를 선언하고, 모든 작업이 준비될 때까지 하나의 대체 콘텐츠를 표시할 수 있습니다.
두 슬롯: 기본과 fallback
Suspense는 이름이 지정된 두 슬롯을 제공합니다.
- default — 비동기 컴포넌트나 비동기
setup()을 포함할 수 있는 실제 콘텐츠입니다 - fallback — 기본 슬롯이 확인되는 동안 표시할 콘텐츠입니다
모든 비동기 종속성이 완료되면 Vue가 fallback을 기본 콘텐츠로 교체합니다.
<template>
<Suspense>
<template #default>
<UserDashboard />
</template>
<template #fallback>
<div class="spinner">Loading dashboard...</div>
</template>
</Suspense>
</template>종속성으로서의 비동기 setup()
컴포넌트의 setup() 함수가 async로 선언되고 무언가를 기다리면 해당 컴포넌트는 비동기 종속성이 됩니다. Vue가 반환된 프로미스를 추적합니다.
<script setup>에서는 블록 내부에서 최상위 await를 직접 사용하는 방식이 이에 해당합니다.
<script setup>
import { ref } from 'vue'
// Top-level await makes this an async dependency of Suspense
const res = await fetch('/api/profile')
const profile = ref(await res.json())
</script>
<template>
<h1>Welcome, {{ profile.name }}</h1>
</template>비동기 컴포넌트도 포함됩니다
defineAsyncComponent으로 만든 컴포넌트도 Suspense가 추적합니다. 동적 import()가 완료될 때까지 대체 콘텐츠가 계속 표시됩니다.
따라서 컴포넌트마다 별도의 로딩 UI를 작성하지 않고도 무거운 컴포넌트를 코드 분할할 수 있습니다.
<script setup>
import { defineAsyncComponent } from 'vue'
const Chart = defineAsyncComponent(() =>
import('./HeavyChart.vue')
)
</script>
<template>
<Suspense>
<Chart />
<template #fallback>Preparing chart...</template>
</Suspense>
</template>여러 비동기 자식이 함께 대기함
기본 슬롯에 여러 비동기 의존성이 포함되어 있으면, Suspense는 콘텐츠를 표시하기 전에 모두 해결될 때까지 기다립니다.
이렇게 하면 컴포넌트가 한 번에 하나씩 나타나면서 레이아웃이 이동하는 현상을 막을 수 있습니다.
<template>
<Suspense>
<div>
<UserStats /> <!-- async setup -->
<RecentOrders /> <!-- async setup -->
<Recommendations /> <!-- async component -->
</div>
<template #fallback>
<PageSkeleton />
</template>
</Suspense>
</template>onErrorCaptured로 거부 처리하기
비동기 setup()이 거부되면(예: 가져오기에 실패한 경우), 오류가 부모 컴포넌트에서 가장 가까운 onErrorCaptured 훅으로 전파됩니다.
Suspense 자체는 오류를 렌더링하지 않으므로 오류 경계와 함께 사용해야 합니다.
<script setup>
import { ref, onErrorCaptured } from 'vue'
const error = ref(null)
onErrorCaptured((err) => {
error.value = err
return false // stop the error from propagating further
})
</script>오류 경계와 Suspense 패턴
일반적인 프로덕션 패턴에서는 오류 경계 컴포넌트 안에 Suspense를 넣습니다. onErrorCaptured는 전파를 중지하고 대신 오류 화면을 렌더링하도록 false를 반환합니다.
<script setup>
import { ref, onErrorCaptured } from 'vue'
const err = ref(null)
onErrorCaptured((e) => { err.value = e; return false })
</script>
<template>
<p v-if="err">Failed to load: {{ err.message }}</p>
<Suspense v-else>
<ProfilePanel />
<template #fallback>Loading...</template>
</Suspense>
</template>pending 및 resolve 이벤트
Suspense는 수명 주기 이벤트를 발생시키며, 다음과 같이 수신할 수 있습니다.
- @pending — 대기 중인 (loading) 상태로 들어갈 때 발생
- @resolve — 기본 슬롯의 해결이 완료될 때 발생
- @fallback — 대체 콘텐츠가 표시될 때 발생
분석이나 진행률 표시줄에 유용합니다.
<template>
<Suspense @pending="onPending" @resolve="onResolve">
<RouteView />
<template #fallback>Loading route...</template>
</Suspense>
</template>지연된 대체 콘텐츠를 위한 타임아웃 속성
timeout 속성은 대체 콘텐츠 표시를 지연시키는 시간(밀리초)입니다. 비동기 작업이 타임아웃보다 빨리 해결되면 대체 콘텐츠는 표시되지 않습니다.
이렇게 하면 빠른 응답에서 회전 표시기가 잠깐 나타나는 현상을 피할 수 있습니다.
<template>
<!-- Only show fallback if loading exceeds 200ms -->
<Suspense :timeout="200">
<FastPanel />
<template #fallback>Loading...</template>
</Suspense>
</template>라우터 및 전환 효과와 함께 사용하는 Suspense
Suspense는 RouterView 및 Transition과 함께 사용하여 비동기 라우트 변경을 애니메이션으로 처리할 수 있습니다. 순서가 중요합니다. Transition이 Suspense를 감싸고, Suspense가 라우트 컴포넌트를 감싸야 합니다.
<template>
<RouterView v-slot="{ Component }">
<Transition mode="out-in">
<Suspense>
<component :is="Component" />
<template #fallback>Loading page...</template>
</Suspense>
</Transition>
</RouterView>
</template>Suspense를 사용하지 말아야 할 때(NOT)
컴포넌트가 마운트된 상태에서 자주 다시 가져오는 데이터에는 Suspense를 사용하지 마세요. Suspense는 초기 비동기 해결만 관리합니다. 지속적인 로딩 상태(페이지 매김, 다시 가져오기)에는 일반적인 반응형 loading ref를 대신 사용하세요.
<script setup>
import { ref } from 'vue'
const loading = ref(false)
async function loadMore() {
loading.value = true
await fetchNextPage()
loading.value = false
}
</script>빠른 확인
Suspense에 대한 이해도를 확인해 보세요.
복습
Suspense가 비동기 의존성을 조정하는 방법을 배웠습니다.
- default 슬롯은 비동기 콘텐츠(비동기 setup 또는 비동기 컴포넌트)를 담습니다.
- fallback 슬롯은 로딩 중에 표시됩니다.
- 콘텐츠를 표시하기 전에 모든 비동기 자식이 완료될 때까지 기다립니다.
- 거부는 부모 오류 경계의
onErrorCaptured로 전파됩니다. timeout은 회전 표시기가 잠깐 나타나는 현상을 피하고,@resolve같은 이벤트는 분석에 도움을 줍니다.
AI 튜터와 함께 HTML을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 42
- 레슨
- 156
자주 묻는 질문
“Vue Suspense 컴포넌트” 강의는 무료인가요?
네 — “Vue Suspense 컴포넌트” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vue Academy 강의 전체를 잠금 해제할 수 있습니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“Vue Suspense 컴포넌트”에서 뭘 배우나요?
기본 및 #fallback 슬롯을 사용하는 , 비동기 컴포넌트 로딩과 중첩 Suspense를 다룹니다. 브라우저에서 직접 실행하는 실습 코드로 Vue Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Vue Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Vue Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“Vue Suspense 컴포넌트” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Vue Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Vue Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.