컴포넌트 Props와 Emits
defineProps로 데이터를 하위로 전달하고 defineEmits로 이벤트를 상위로 발생시키며, type 및 required 제약 조건으로 props를 검증합니다.
컴포넌트 Props와 Emits은(는) CoddyKit의 무료 Frontend Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Frontend Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Frontend Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
Vue 3의 속성
속성은 부모에서 자식으로 데이터를 전달합니다. <script setup>에서는 defineProps()를 사용하여 속성을 선언합니다. 속성은 자식 컴포넌트에서 읽기 전용이므로 직접 변경해서는 안 됩니다.
<script setup lang="ts">
const props = defineProps<{
title: string;
count?: number;
variant?: 'primary' | 'secondary';
}>();
</script>
<template>
<h2>{{ title }} ({{ count ?? 0 }})</h2>
</template>속성 기본값에 withDefaults 사용하기
defineProps()를 withDefaults()로 감싸 기본값을 지정합니다.
<script setup lang="ts">
const props = withDefaults(defineProps<{
count?: number;
variant?: 'primary' | 'secondary';
}>(), {
count: 0,
variant: 'primary'
});
</script>템플릿에서 속성 전달하기
정적 값은 일반 속성으로 전달합니다. 동적 값은 v-bind(:)를 사용하여 전달합니다. 불리언 속성은 값 없이 존재 여부만 지정하여 전달합니다.
<MyButton title="Submit" :count="activeCount" variant="primary" />
<Toggle :disabled="isLoading" />emit — 자식에서 부모로 통신하기
자식 컴포넌트는 이벤트를 방출하여 부모와 통신합니다. defineEmits()를 사용하여 컴포넌트가 방출할 수 있는 이벤트를 선언한 다음, 반환된 emit 함수를 호출합니다.
<script setup lang="ts">
const emit = defineEmits<{
update: [value: string];
close: [];
submit: [data: FormData];
}>();
function handleSubmit(data: FormData) {
emit('submit', data); // fire the event
}
</script>부모에서 emit 수신하기
템플릿에서 @eventName을 사용하여 자식 컴포넌트의 사용자 지정 이벤트를 수신합니다.
<SearchInput
@update="searchTerm = $event"
@submit="handleSearch"
/>사용자 지정 컴포넌트와 v-model
사용자 지정 컴포넌트에서 v-model은 :modelValue + @update:modelValue의 단축형입니다. 컴포넌트는 해당 속성을 받아들이고 업데이트 이벤트를 방출해야 합니다.
<!-- Parent: -->
<MyInput v-model="email" />
<!-- MyInput.vue: -->
<script setup lang="ts">
defineProps<{ modelValue: string }>();
const emit = defineEmits<{ 'update:modelValue': [string] }>();
</script>
<template>
<input :value="modelValue" @input="emit('update:modelValue', ($event.target as HTMLInputElement).value)" />
</template>여러 v-model 바인딩
Vue 3에서는 이름이 지정된 수식어를 사용하여 하나의 컴포넌트에 여러 v-model을 사용할 수 있습니다.
<UserForm v-model:firstName="user.firstName" v-model:lastName="user.lastName" />속성 검증
옵션 API나 런타임 속성 선언에서 유형, 필수 여부, 검증기 제약을 추가합니다. TypeScript 기반 defineProps()는 컴파일 시점에 이러한 기능을 제공합니다.
속성과 데이터 — 단방향 흐름
Vue는 단방향 데이터 흐름을 강제합니다. 속성은 부모에서 자식으로 흐르고 이벤트는 자식에서 부모로 흐릅니다. 자식이 데이터를 변경해야 한다면 이벤트를 방출하고 부모가 업데이트를 처리합니다.
속성의 대안으로 사용하는 슬롯
단순한 데이터가 아니라 HTML이나 컴포넌트가 되어야 하는 콘텐츠에는 슬롯을 사용합니다. 부모는 컴포넌트 태그 안에 콘텐츠를 제공하고, 자식은 <slot />으로 이를 렌더링합니다.
<!-- Parent: -->
<Card title="Hello">
<p>This content goes in the default slot.</p>
</Card>
<!-- Card.vue: -->
<template>
<div class="card">
<h2>{{ title }}</h2>
<slot /> <!-- renders the p tag -->
</div>
</template>빠른 확인
자식 Vue 컴포넌트는 이벤트를 부모에게 어떻게 전달하나요?
복습: 속성과 emit
유형이 지정된 속성 선언에는 defineProps를 사용합니다. 기본값에는 withDefaults를 사용합니다. 속성은 자식 컴포넌트에서 읽기 전용입니다. 방출되는 이벤트를 선언하고 유형을 지정하려면 defineEmits를 사용합니다. 부모에서는 @eventName으로 이벤트를 수신합니다. v-model = :modelValue + @update:modelValue입니다. 단방향 데이터 흐름에서는 속성이 아래로, 이벤트가 위로 흐릅니다. 콘텐츠나 템플릿 조각을 전달할 때는 슬롯을 사용합니다.
자주 묻는 질문
“컴포넌트 Props와 Emits” 강의는 무료인가요?
네 — “컴포넌트 Props와 Emits” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Frontend Academy 강의 전체를 잠금 해제할 수 있습니다. Frontend Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“컴포넌트 Props와 Emits”에서 뭘 배우나요?
defineProps로 데이터를 하위로 전달하고 defineEmits로 이벤트를 상위로 발생시키며, type 및 required 제약 조건으로 props를 검증합니다. 브라우저에서 직접 실행하는 실습 코드로 Frontend Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Frontend Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Frontend Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“컴포넌트 Props와 Emits” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Frontend Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Frontend Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- Vue SFC: script, template, style
- Options API: data, methods, computed
- 디렉티브: v-if, v-for, v-bind, v-on
- 컴포넌트 Props와 Emits