Kurs Vue.js · Moduł 14: Dyrektywy i pluginy
Directive Hooks - argumenty, modyfikatory, wartości
W tej lekcji6
W Centrum Dowodzenia NOVA LAB każdy system wymaga precyzyjnych parametrów. Dyrektywy Vue oferują bogaty zestaw danych przez obiekt binding.
Obiekt binding
Każdy hook dyrektywy otrzymuje dwa główne parametry: el (element DOM) i binding (obiekt z danymi):
app.directive('demo', {
mounted(el, binding) {
// binding.value - wartość przekazana: v-demo="123" => 123
// binding.arg - argument: v-demo:color => 'color'
// binding.modifiers - modyfikatory: v-demo.bold => { bold: true }
// binding.oldValue - poprzednia wartość (w updated)
}
})Wartość dyrektywy: binding.value
Wartość to wyrażenie JavaScript przekazane po =:
<template>
<div v-color="'#00ff88'">Zielony tekst</div>
<div v-color="themeColor">Dynamiczny kolor</div>
<div v-color="{ bg: '#0a0e27', text: '#00ff88' }">Obiekt</div>
</template>app.directive('color', (el, binding) => {
if (typeof binding.value === 'string') {
el.style.color = binding.value
} else {
el.style.backgroundColor = binding.value.bg
el.style.color = binding.value.text
}
})Argumenty: binding.arg
Argument to część po dwukropku - pozwala określić, co dyrektywa ma modyfikować:
<template>
<div v-style:color="'#00ff88'">Kolor tekstu</div>
<div v-style:backgroundColor="'#0a0e27'">Kolor tła</div>
<div v-style:fontSize="'20px'">Rozmiar czcionki</div>
</template>app.directive('style', (el, binding) => {
if (binding.arg) {
el.style[binding.arg] = binding.value
}
})Dynamiczne argumenty
Argument może być dynamiczny - użyj nawiasów kwadratowych:
<script setup>
import { ref } from 'vue'
const prop = ref('color')
</script>
<template>
<div v-style:[prop]="'#00ff88'">Dynamiczny atrybut</div>
</template>Modyfikatory: binding.modifiers
Modyfikatory to flagi boolowskie po kropce:
<template>
<p v-format.bold.uppercase>stacja nova lab</p>
</template>app.directive('format', (el, binding) => {
if (binding.modifiers.bold) {
el.style.fontWeight = 'bold'
}
if (binding.modifiers.uppercase) {
el.textContent = el.textContent.toUpperCase()
}
if (binding.modifiers.italic) {
el.style.fontStyle = 'italic'
}
})Łączenie wszystkiego razem
Pełna składnia dyrektywy:
v-nazwa:argument.modyfikator1.modyfikator2="wartosc"Przykład:
<div v-tooltip:top.slow="'Informacja o stacji'">
Najedz na mnie
</div>Gdzie:
tooltip- nazwa dyrektywytop- argument (pozycja)slow- modyfikator (animacja)'Informacja o stacji'- wartość (tekst)
Kod do tej lekcji: App.vue
<script setup>
import { ref } from 'vue'
// Dyrektywa z binding.arg
const vStyle = (el, binding) => {
if (binding.arg) {
el.style[binding.arg] = binding.value
}
}
// Dyrektywa z binding.modifiers
const vFormat = (el, binding) => {
let text = el.textContent
if (binding.modifiers.uppercase) {
text = text.toUpperCase()
}
if (binding.modifiers.lowercase) {
text = text.toLowerCase()
}
el.textContent = text
if (binding.modifiers.bold) {
el.style.fontWeight = 'bold'
}
if (binding.modifiers.italic) {
el.style.fontStyle = 'italic'
}
}
// Dyrektywa laczaca wszystko
const vPanel = {
mounted(el, binding) {
const color = binding.value || '#00ff88'
const size = binding.arg || 'md'
const paddings = { sm: '8px', md: '16px', lg: '24px' }
el.style.border = '2px solid ' + color
el.style.padding = paddings[size] || paddings.md
el.style.borderRadius = '8px'
if (binding.modifiers.glow) {
el.style.boxShadow = '0 0 15px ' + color + '40'
}
if (binding.modifiers.dashed) {
el.style.borderStyle = 'dashed'
}
}
}
const dynamicProp = ref('color')
</script>
<template>
<div class="nova-lab">
<h1>Directive Hooks - Args & Modifiers</h1>
<section class="section">
<h2>binding.arg (v-style:property)</h2>
<p v-style:color="'#00ff88'">Kolor zielony</p>
<p v-style:fontSize="'20px'">Wieksza czcionka</p>
<p v-style:backgroundColor="'rgba(0, 180, 216, 0.2)'">Tlo cyan</p>
</section>
<section class="section">
<h2>binding.modifiers (v-format.bold.uppercase)</h2>
<p v-format.uppercase>stacja nova lab</p>
<p v-format.bold.italic>wazny komunikat</p>
<p v-format.uppercase.bold>alarm czerwony</p>
</section>
<section class="section">
<h2>Wszystko razem: v-panel</h2>
<div v-panel:md.glow="'#00ff88'" style="margin-bottom: 10px">
<p>v-panel:md.glow="#00ff88"</p>
</div>
<div v-panel:lg.dashed="'#00b4d8'" style="margin-bottom: 10px">
<p>v-panel:lg.dashed="#00b4d8"</p>
</div>
<div v-panel:sm.glow.dashed="'#e74c3c'">
<p>v-panel:sm.glow.dashed="#e74c3c"</p>
</div>
</section>
<section class="section">
<h2>Dynamiczny argument: v-style:[prop]</h2>
<select v-model="dynamicProp" class="select">
<option value="color">color</option>
<option value="fontSize">fontSize</option>
<option value="backgroundColor">backgroundColor</option>
</select>
<p v-style:[dynamicProp]="dynamicProp === 'fontSize' ? '22px' : dynamicProp === 'backgroundColor' ? 'rgba(0,255,136,0.2)' : '#00b4d8'" style="margin-top: 8px">
Tekst zmienia sie dynamicznie
</p>
</section>
</div>
</template>
<style scoped>
.nova-lab {
background: #0a0e27;
color: #c0c0c0;
min-height: 100vh;
padding: 20px;
font-family: monospace;
}
h1 { color: #00ff88; margin-bottom: 20px; }
h2 { color: #00b4d8; font-size: 16px; margin-bottom: 10px; }
.section {
background: rgba(0, 180, 216, 0.05);
border: 1px solid rgba(0, 180, 216, 0.2);
padding: 15px;
border-radius: 8px;
margin-bottom: 15px;
}
.select {
background: #0a0e27;
color: #00ff88;
border: 1px solid #00ff88;
padding: 8px;
border-radius: 4px;
font-family: monospace;
}
</style>Hasła z dokumentacji w tej lekcji
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Co zawiera binding.value w dyrektywie v-demo="123"?
2. Co zwraca binding.arg w dyrektywie v-style:color="'red'"?
To 2 z 3 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Edytor kodu
Użyj binding.arg jako nazwę właściwości CSS i binding.value jako wartość.
- Układanie w poziomie
Ułóż poprawną składnię dyrektywy z argumentem i wartością:
- Edytor kodu
Sprawdzaj binding.modifiers.bold, binding.modifiers.uppercase i binding.modifiers.italic.