Vue Academy · 강의

v-model: 양방향 바인딩의 내부 동작

v-model이 :modelValue + @update:modelValue로 컴파일되는 방식, 사용자 지정 v-model 이름, 컴포넌트에서의 v-model을 다룹니다.

v-model: 양방향 바인딩의 내부 동작은(는) CoddyKit의 무료 Vue Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Vue Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

v-model의 실제 의미

v-model은 마법 같은 양방향 바인딩처럼 보이지만, 실제로는 값 연결과 이벤트 수신기를 줄여 쓴 것입니다. 이것이 어떻게 확장되는지 이해하면 입력 요소와 사용자 지정 컴포넌트 모두에서 사용할 수 있습니다.

텍스트 입력에 v-model 사용하기

네이티브 입력 요소에서 v-model은 값을 연결하고 input 이벤트를 수신합니다. 다음 두 줄은 같은 의미입니다.

<!-- shorthand -->
<input v-model="text" />

<!-- expanded -->
<input :value="text" @input="text = $event.target.value" />

두 부분: 연결하고 수신하기

:value는 상태를 요소에 전달하고, @input은 사용자의 변경 사항을 다시 상태로 전달합니다. 이 둘이 함께 양방향 동작을 만듭니다.

컴포넌트에서의 v-model은 다릅니다

사용자 정의 컴포넌트에서 v-model은 다른 속성과 이벤트인 modelValue와 update:modelValue를 사용합니다. 네이티브 value/input은 네이티브 요소에만 사용됩니다.

<!-- on a component -->
<MyInput v-model="text" />

<!-- expands to -->
<MyInput :model-value="text" @update:model-value="text = $event" />

자식 컴포넌트에서 v-model 구현하기

v-model을 지원하려면 자식 컴포넌트에서 modelValue 속성을 선언하고 값이 변경되어야 할 때 update:modelValue를 발생시켜야 합니다.

<script setup>
defineProps(['modelValue'])
const emit = defineEmits(['update:modelValue'])
function onInput(e) { emit('update:modelValue', e.target.value) }
</script>

자식 컴포넌트의 템플릿

자식 컴포넌트는 전달받은 속성을 입력 요소에 연결하고 변경될 때 이벤트를 발생시킵니다. 부모 컴포넌트는 내부 세부 사항을 전혀 알 필요가 없습니다.

<template>
  <input :value="modelValue" @input="onInput" />
</template>

이름이 지정된 v-model 인자

모델에 이름을 지정하여 특정 속성을 대상으로 삼을 수 있습니다. v-model:title은 title 속성과 update:title 이벤트를 사용합니다.

<!-- parent -->
<MyDialog v-model:title="pageTitle" />

<!-- expands to -->
<MyDialog :title="pageTitle" @update:title="pageTitle = $event" />

자식 컴포넌트에서 이름이 지정된 모델 선언하기

자식 컴포넌트에서는 해당 이름의 속성과 그에 대응하는 이벤트를 선언하기만 하면 됩니다.

<script setup>
defineProps(['title'])
const emit = defineEmits(['update:title'])
</script>

하나의 컴포넌트에서 여러 v-model 사용하기

각 모델마다 고유한 이름이 있으므로 여러 모델을 한 번에 바인딩할 수 있습니다. 사용자 양식 컴포넌트는 v-model:first와 v-model:last를 동시에 제공할 수 있습니다.

<UserName
  v-model:first="firstName"
  v-model:last="lastName"
/>

이 설계가 강력한 이유

v-model은 속성과 이벤트의 조합일 뿐이므로 사용자 정의 컴포넌트도 사용하는 쪽에서는 네이티브 입력 요소와 똑같이 느껴집니다. 이름이 지정된 여러 모델을 사용하면 하나의 컴포넌트에서 여러 양방향 바인딩을 깔끔하게 관리할 수 있습니다.

흔한 실수

자식 컴포넌트 안에서 modelValue 속성을 직접 변경하지 마세요. 이렇게 하면 단방향 속성 흐름이 깨집니다. 항상 업데이트 이벤트를 발생시키고 상태는 부모 컴포넌트가 관리하도록 하세요.

빠른 확인

v-model의 내부 동작에 대한 이해도를 확인해 보세요.

복습

v-model의 작동 방식을 살펴보았습니다.

입력 요소에서는 :value + @input으로 확장됩니다.
컴포넌트에서는 modelValue + update:modelValue를 사용합니다.
이름이 지정된 모델(v-model:title)은 특정 속성과 이벤트를 대상으로 합니다.
하나의 컴포넌트에서 여러 v-model을 사용할 수 있습니다.

자주 묻는 질문

“v-model: 양방향 바인딩의 내부 동작” 강의는 무료인가요?

네 — “v-model: 양방향 바인딩의 내부 동작” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vue Academy 강의 전체를 잠금 해제할 수 있습니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“v-model: 양방향 바인딩의 내부 동작”에서 뭘 배우나요?

v-model이 :modelValue + @update:modelValue로 컴파일되는 방식, 사용자 지정 v-model 이름, 컴포넌트에서의 v-model을 다룹니다. 브라우저에서 직접 실행하는 실습 코드로 Vue Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Vue Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Vue Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“v-model: 양방향 바인딩의 내부 동작” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Vue Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Vue Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Vue Academy(으)로 돌아가기