script setup에서 컴포저블 가져오고 사용하기
컴포저블 가져오기, 서드파티 VueUse 컴포저블 사용, import 구성 방법을 다룹니다.
script setup에서 컴포저블 가져오고 사용하기은(는) CoddyKit의 무료 Vue Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Vue Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
컴포저블과 script setup
컴포저블은 반응형 로직을 재사용할 수 있도록 묶어 둔 함수입니다. <script setup>에서는 최상위에서 가져와 호출하기만 하면 간단하게 사용할 수 있습니다.
최상위에서 가져오기
항상 <script setup>의 최상위에서 컴포저블을 호출하십시오. 조건문, 반복문 또는 중첩 함수 안에서 호출해서는 안 됩니다. 이렇게 해야 Vue가 반응성과 수명 주기 훅을 올바르게 등록할 수 있습니다.
<script setup>
import { useCounter } from './useCounter'
const { count, increment } = useCounter()
</script>최상위 호출이 중요한 이유
컴포저블은 onMounted와 같은 수명 주기 훅을 등록하거나 감시 기능을 설정하는 경우가 많습니다. 이러한 작업은 컴포넌트 설정 중에 실행되어야 하며, 컴포저블을 최상위에서 동기적으로 호출할 때만 설정이 진행됩니다.
필요한 항목만 구조 분해하기
컴포저블은 반응형 값과 함수로 이루어진 객체를 반환합니다. 컴포넌트에서 사용하는 항목만 구조 분해하고, 같은 컴포저블을 두 번 호출할 때는 이름을 바꾸어 충돌을 피하십시오.
<script setup>
import { useMouse } from './useMouse'
const { x: mouseX, y: mouseY } = useMouse()
</script>VueUse 알아보기
VueUse는 바로 사용할 수 있는 컴포저블을 모아 둔 인기 라이브러리입니다. 자주 사용하는 로직을 직접 작성하는 대신 테스트된 컴포저블을 가져오십시오. 한 번 설치한 후 필요한 항목을 가져오면 됩니다.
<script setup>
import { useLocalStorage } from '@vueuse/core'
const name = useLocalStorage('name', 'Alice')
</script>useLocalStorage 사용하기
useLocalStorage는 localStorage와 동기화되는 ref를 반환합니다. ref를 변경하면 브라우저 저장소가 업데이트되고, 페이지를 다시 로드해도 값이 유지됩니다.
<template>
<input v-model="name" />
<p>Saved: {{ name }}</p>
</template>반응형 좌표에 useMouse 사용하기
useMouse는 포인터 위치를 반응형 참조로 추적합니다. 이벤트 수신기를 대신 추가하고 제거하므로 정리를 직접 관리할 필요가 없습니다.
<script setup>
import { useMouse } from '@vueuse/core'
const { x, y } = useMouse()
</script>
<template>
<p>{{ x }}, {{ y }}</p>
</template>컴포저블 조합하기
컴포저블은 다른 컴포저블을 호출할 수 있습니다. 이러한 계층화가 Composition API의 핵심입니다. 작은 조각을 만들고 이를 결합하여 더 큰 기능을 구성하십시오.
import { useMouse } from '@vueuse/core'
export function useMouseDistance() {
const { x, y } = useMouse()
const distance = computed(() => Math.hypot(x.value, y.value))
return { distance }
}최상위 await
<script setup>에서는 최상위에서 await를 직접 사용할 수 있습니다. 컴포넌트가 비동기 setup이 되며, 프레임워크는 프로미스가 해결될 때까지 렌더링을 일시 중지할 수 있습니다.
<script setup>
const res = await fetch('/api/user')
const user = await res.json()
</script>비동기 Setup에서 Suspense 사용하기
최상위 await를 사용하는 컴포넌트는 부모가 <Suspense> 경계로 감싸야 합니다. Suspense는 비동기 setup이 완료될 때까지 대체 콘텐츠를 표시합니다.
<template>
<Suspense>
<AsyncUser />
<template #fallback>Loading...</template>
</Suspense>
</template>모범 사례
- 컴포저블 이름에
use접두사를 사용하십시오. - 최상위에서만 호출하십시오.
- 참조를 반환하거나,
toRefs로 감싼reactive를 반환하십시오. - 직접 작성하기 전에 일반적인 요구 사항에는 VueUse를 우선 사용하십시오.
빠른 확인
컴포저블에 대한 이해를 확인해 보십시오.
복습
컴포저블을 사용하는 방법을 배웠습니다.
<script setup>의 최상위에서 가져와 호출합니다.- 필요한 항목만 구조 분해하고 이름을 바꿉니다.
- VueUse는
useLocalStorage와useMouse같은 바로 사용할 수 있는 컴포저블을 제공합니다. - 최상위
await는 setup을 비동기로 만들며<Suspense>와 함께 사용합니다.
자주 묻는 질문
“script setup에서 컴포저블 가져오고 사용하기” 강의는 무료인가요?
네 — “script setup에서 컴포저블 가져오고 사용하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vue Academy 강의 전체를 잠금 해제할 수 있습니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“script setup에서 컴포저블 가져오고 사용하기”에서 뭘 배우나요?
컴포저블 가져오기, 서드파티 VueUse 컴포저블 사용, import 구성 방법을 다룹니다. 브라우저에서 직접 실행하는 실습 코드로 Vue Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Vue Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Vue Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“script setup에서 컴포저블 가져오고 사용하기” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Vue Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Vue Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- script setup 소개
- defineProps와 defineEmits
- defineExpose와 useAttrs
- script setup에서 컴포저블 가져오고 사용하기