setup() 함수와 반응형 변수
setup() 진입점, 원시 값에 사용하는 ref(), 객체에 사용하는 reactive(), 값 반환 방법을 다룹니다.
setup() 함수와 반응형 변수은(는) CoddyKit의 무료 Vue Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Vue Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
setup() 진입점
컴포지션 API는 setup()이라는 특별한 컴포넌트 옵션 안에서 사용합니다. 이 함수는 컴포넌트가 생성되기 전에 한 번 실행되며, 반응형 상태와 함수를 선언하는 곳입니다.
setup()에서 return하는 것은 무엇이든 템플릿에서 사용할 수 있게 됩니다.
ref로 반응형 상태 만들기
ref()는 하나의 값(숫자, 문자열, 불리언 또는 객체)을 반응형 컨테이너로 감쌉니다. 실제 값은 .value 속성에 저장됩니다.
import { ref } from 'vue'
export default {
setup() {
const count = ref(0)
console.log(count.value) // 0
return { count }
}
}reactive로 반응형 객체 만들기
reactive()는 일반 객체를 받아 깊은 반응형 프록시를 반환합니다. 속성에 직접 접근하며 .value는 사용하지 않습니다.
import { reactive } from 'vue'
export default {
setup() {
const user = reactive({ name: 'Alice', age: 30 })
console.log(user.name) // Alice
return { user }
}
}템플릿에 상태 반환하기
setup()에서 객체로 반환한 모든 항목은 템플릿 바인딩이 됩니다. 여기서는 count와 user가 모두 노출됩니다.
export default {
setup() {
const count = ref(0)
const user = reactive({ name: 'Alice' })
return { count, user }
}
}템플릿에서 자동으로 래핑 해제하기
JavaScript에서는 count.value라고 작성했지만, 템플릿에서는 count라고만 작성합니다. Vue가 최상위 ref의 래핑을 자동으로 해제하므로 템플릿에서는 .value를 입력할 필요가 없습니다.
<!-- template -->
<p>Count: {{ count }}</p>
<p>Name: {{ user.name }}</p>함수 추가하기
setup()에서 정의한 함수는 반응형 상태를 읽고 변경할 수 있습니다. JavaScript 내부에서는 ref에 .value를 계속 사용해야 한다는 점을 기억하십시오.
import { ref } from 'vue'
export default {
setup() {
const count = ref(0)
function increment() { count.value++ }
return { count, increment }
}
}템플릿에 연결하기
함수를 반환하고 이벤트에 연결하십시오. 버튼을 클릭하면 increment가 호출되어 ref를 변경하고, Vue가 화면을 다시 렌더링합니다.
<!-- template -->
<button @click="increment">Count is {{ count }}</button>this 키워드가 필요하지 않습니다
setup() 안에는 this가 없습니다. 선언한 변수를 직접 사용합니다. 따라서 코드를 이해하기 쉽고 TypeScript와도 더 잘 맞습니다.
setup()에서 this를 사용해도 컴포넌트 인스턴스를 얻을 수 없습니다.
setup은 생성 전에 실행됩니다
setup()은 매우 이른 시점에 실행됩니다. created보다 먼저 실행되며 컴포넌트 인스턴스가 완전히 설정되기 전입니다. 그렇기 때문에 this를 사용할 수 없고, 이 시점에는 아직 DOM에 접근할 수 없습니다.
setup 인수: props와 context
setup(props, context)는 해석된 props를 첫 번째 인수로 받고 context 객체를 두 번째 인수로 받습니다. context에는 attrs, slots, emit, expose가 포함됩니다.
export default {
props: { title: String },
setup(props, context) {
console.log(props.title)
context.emit('ready')
}
}완성된 미니 컴포넌트
여기에는 ref, 반응형 객체, 함수, 그리고 반환된 바인딩이 모두 함께 나와 있습니다.
import { ref, reactive } from 'vue'
export default {
setup() {
const count = ref(0)
const user = reactive({ name: 'Alice' })
function increment() { count.value++ }
return { count, user, increment }
}
}빠른 확인
setup()과 반응형 변수를 제대로 이해했는지 확인해 보십시오.
복습
컴포지션 API의 기초를 배웠습니다.
setup()은 생성 전에 한 번 실행되며 템플릿 바인딩을 반환합니다.ref()는 값을 감쌉니다. JS에서는.value를 사용하십시오.reactive()는 객체를 감싸며 속성에 직접 접근합니다.- 템플릿은 ref의 래핑을 자동으로 해제하므로 그곳에서는
.value를 생략합니다. setup()안에는this가 없습니다.
자주 묻는 질문
“setup() 함수와 반응형 변수” 강의는 무료인가요?
네 — “setup() 함수와 반응형 변수” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vue Academy 강의 전체를 잠금 해제할 수 있습니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“setup() 함수와 반응형 변수”에서 뭘 배우나요?
setup() 진입점, 원시 값에 사용하는 ref(), 객체에 사용하는 reactive(), 값 반환 방법을 다룹니다. 브라우저에서 직접 실행하는 실습 코드로 Vue Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Vue Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Vue Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.
“setup() 함수와 반응형 변수” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Vue Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Vue Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- Composition API를 사용하는 이유
- setup() 함수와 반응형 변수
- ref와 reactive: 각각 언제 사용할까요
- Composition API의 Computed와 Watch