Pisanie własnych dyrektyw
app.directive(), hooki mounted/updated/unmounted, argumenty i modyfikatory dyrektyw.
Pisanie własnych dyrektyw to bezpłatna lekcja Vue Academy na CoddyKit. To lekcja 4 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.
Gdy komponenty nie wystarczają
Większość elementów wielokrotnego użytku w Vue tworzy się za pomocą komponentów i funkcji composable. Czasami jednak logika dotyczy surowego DOM — na przykład automatycznego ustawiania fokusu w polu wejściowym, integracji z biblioteką spoza Vue lub mierzenia elementu. Dyrektywy niestandardowe służą właśnie do takich zadań.
Minimalna dyrektywa
Dyrektywę rejestruje się w aplikacji za pomocą app.directive. Hook mounted otrzymuje element, więc ta dyrektywa ustawia fokus w polu wejściowym, gdy pojawi się ono na stronie.
const app = createApp(App)
app.directive('focus', {
mounted(el) { el.focus() }
})Używanie dyrektywy
Dyrektywę stosuje się w szablonie za pomocą prefiksu v- oraz zarejestrowanej nazwy.
<template>
<input v-focus />
</template>Lokalne dyrektywy w script setup
Wewnątrz <script setup> każda zmienna najwyższego poziomu, której nazwa zaczyna się od v i jest zapisana w camelCase, staje się dostępną dyrektywą. Należy nazwać ją vFocus i używać jako v-focus.
<script setup>
const vFocus = {
mounted: (el) => el.focus()
}
</script>
<template>
<input v-focus />
</template>Obiekt binding
Każdy hook otrzymuje obiekt binding jako drugi argument. Zawiera on wartość dyrektywy, argument i modyfikatory przekazane w szablonie.
app.directive('demo', {
mounted(el, binding) {
console.log(binding.value, binding.arg, binding.modifiers)
}
})Przekazywanie wartości
Wyrażenie po znaku równości staje się wartością binding.value. W tym przykładzie przekazywany jest kolor, który następnie zostaje zastosowany do elementu.
<!-- template -->
<p v-color="'red'">Hello</p>
<!-- directive -->
app.directive('color', {
mounted(el, binding) { el.style.color = binding.value }
})Przekazywanie argumentu
Część znajdująca się po dwukropku staje się wartością binding.arg. Dzięki niej jedna dyrektywa może działać inaczej w zależności od etykiety.
<!-- v-pin:top means binding.arg === 'top' -->
<div v-pin:top="20"></div>Używanie modyfikatorów
Modyfikatory występują po kropkach i trafiają do binding.modifiers jako mapa wartości logicznych. Można ich używać do modyfikowania działania dyrektywy.
<!-- v-pin.fixed -> binding.modifiers.fixed === true -->
<div v-pin.fixed="10"></div>Hooki cyklu życia dyrektywy
Dyrektywy mają hooki odzwierciedlające cykl życia komponentu: created, beforeMount, mounted, beforeUpdate, updated, beforeUnmount oraz unmounted.
Reagowanie na aktualizacje
Hook updated jest uruchamiany po ponownym renderowaniu elementu. Należy porównać binding.value z binding.oldValue, aby reagować tylko na rzeczywiste zmiany, a sprzątanie wykonać w hooku unmounted.
app.directive('color', {
mounted(el, binding) { el.style.color = binding.value },
updated(el, binding) {
if (binding.value !== binding.oldValue) el.style.color = binding.value
}
})Dyrektywy a komponenty
W przypadku wszystkiego, co obejmuje strukturę lub stan, należy wybierać komponenty. Po dyrektywy należy sięgać wyłącznie wtedy, gdy potrzebny jest niskopoziomowy, bezpośredni dostęp do DOM, którego nie da się wygodnie obsłużyć w komponencie, na przykład do zarządzania fokusem lub obsługi widżetów DOM innych firm.
Szybkie sprawdzenie
Proszę sprawdzić swoją wiedzę na temat dyrektyw niestandardowych.
Podsumowanie
Omówiono tworzenie dyrektyw niestandardowych:
- Można rejestrować je globalnie za pomocą
app.directivelub lokalnie jakovNamew script setup. binding.value,binding.argibinding.modifiersprzekazują dane do dyrektywy.- Hooki cyklu życia: created, beforeMount, mounted, beforeUpdate, updated, beforeUnmount, unmounted.
- Dyrektyw należy używać do niskopoziomowej obsługi DOM, a w pozostałych przypadkach wybierać komponenty.
Ucz się HTML dzięki korepetycjom AI — za darmo
Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.
- Kursy
- 42
- Lekcje
- 156
Często zadawane pytania
Czy lekcja „Pisanie własnych dyrektyw” jest bezpłatna?
Tak — pełny tekst „Pisanie własnych dyrektyw” 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 „Pisanie własnych dyrektyw”?
app.directive(), hooki mounted/updated/unmounted, argumenty i modyfikatory dyrektyw. Ć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 4 z 4.
Ile czasu zajmuje lekcja „Pisanie własnych dyrektyw”?
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