v-model: mechanizmy wiązania dwukierunkowego
v-model jest kompilowany do :modelValue + @update:modelValue, własne nazwy v-model, v-model na komponentach.
v-model: mechanizmy wiązania dwukierunkowego to bezpłatna lekcja Vue Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Vue Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Vue Academy zawiera 4 lekcji w sumie.
Czym naprawdę jest v-model
v-model wygląda jak magiczne wiązanie dwukierunkowe, ale jest tylko skrótem dla powiązania wartości z nasłuchiwaniem zdarzenia. Zrozumienie, do czego się rozwija, pozwala używać go zarówno z polami input, jak i z komponentami niestandardowymi.
v-model na polu tekstowym
W przypadku natywnego pola input v-model wiąże wartość i nasłuchuje zdarzeń input. Te dwa wiersze są równoważne.
<!-- shorthand -->
<input v-model="text" />
<!-- expanded -->
<input :value="text" @input="text = $event.target.value" />Dwa elementy: wiązanie i nasłuchiwanie
:value przekazuje stan do elementu, a @input przekazuje zmiany użytkownika z powrotem do stanu. Razem tworzą efekt dwukierunkowego przepływu.
v-model w komponentach działa inaczej
W przypadku komponentu niestandardowego v-model korzysta z innego propu i zdarzenia: modelValue oraz update:modelValue. Natywne value/input są używane wyłącznie w elementach natywnych.
<!-- on a component -->
<MyInput v-model="text" />
<!-- expands to -->
<MyInput :model-value="text" @update:model-value="text = $event" />Implementowanie v-model w komponencie potomnym
Aby obsługiwać v-model, komponent potomny deklaruje prop modelValue i emituje update:modelValue, gdy wartość ma się zmienić.
<script setup>
defineProps(['modelValue'])
const emit = defineEmits(['update:modelValue'])
function onInput(e) { emit('update:modelValue', e.target.value) }
</script>Szablon komponentu potomnego
Komponent potomny wiąże przekazany prop z polem wejściowym i emituje zdarzenie po zmianie. Komponent nadrzędny nie musi znać szczegółów wewnętrznej implementacji.
<template>
<input :value="modelValue" @input="onInput" />
</template>Nazwane argumenty v-model
Można wskazać konkretny prop, nadając nazwę modelowi: v-model:title korzysta z propu title i zdarzenia update:title.
<!-- parent -->
<MyDialog v-model:title="pageTitle" />
<!-- expands to -->
<MyDialog :title="pageTitle" @update:title="pageTitle = $event" />Deklarowanie nazwanego modelu w komponencie potomnym
Komponent potomny po prostu deklaruje prop i pasujące do niego zdarzenie o tej samej nazwie.
<script setup>
defineProps(['title'])
const emit = defineEmits(['update:title'])
</script>Wiele v-model w jednym komponencie
Ponieważ każdy model ma własną nazwę, można powiązać kilka modeli jednocześnie. Komponent formularza użytkownika może na przykład równocześnie udostępniać v-model:first i v-model:last.
<UserName
v-model:first="firstName"
v-model:last="lastName"
/>Dlaczego to rozwiązanie jest tak skuteczne
Ponieważ v-model to tylko połączenie propów i zdarzeń, dla korzystających z nich komponenty niestandardowe zachowują się dokładnie jak natywne pola wejściowe. Wiele nazwanych modeli pozwala jednemu komponentowi w przejrzysty sposób obsługiwać kilka wiązań dwukierunkowych.
Częsty błąd
Nie należy bezpośrednio modyfikować propu modelValue w komponencie potomnym — zaburza to jednokierunkowy przepływ propów. Zawsze należy emitować zdarzenie aktualizacji i pozostawić stan pod kontrolą komponentu nadrzędnego.
Szybkie sprawdzenie
Proszę sprawdzić swoją wiedzę na temat wewnętrznego działania v-model.
Podsumowanie
Omówiono sposób działania v-model:
- W polach wejściowych rozwija się do
:value+@input. - W komponentach korzysta z
modelValue+update:modelValue. - Nazwane modele (
v-model:title) wskazują konkretne propy i zdarzenia. - W jednym komponencie można używać wielu v-model.
Często zadawane pytania
Czy lekcja „v-model: mechanizmy wiązania dwukierunkowego” jest bezpłatna?
Tak — pełny tekst „v-model: mechanizmy wiązania dwukierunkowego” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Vue Academy, przejdź na CoddyKit PRO. Kurs Vue Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „v-model: mechanizmy wiązania dwukierunkowego”?
v-model jest kompilowany do :modelValue + @update:modelValue, własne nazwy v-model, v-model na komponentach. Ćwiczysz Vue Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Vue Academy?
Nie wymagamy żadnego doświadczenia. Vue Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.
Ile czasu zajmuje lekcja „v-model: mechanizmy wiązania dwukierunkowego”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Vue Academy?
Tak. Każda lekcja Vue Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- v-model: mechanizmy wiązania dwukierunkowego
- Modyfikatory zdarzeń v-on
- Dynamiczne i wielokrotne wiązania v-bind
- Pisanie własnych dyrektyw