Kurs Vue.js · Moduł 14: Dyrektywy i pluginy

Directive Hooks - argumenty, modyfikatory, wartości

2 min czytania ·
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 dyrektywy
  • top - 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. 1. Co zawiera binding.value w dyrektywie v-demo="123"?

  2. 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.

  1. PytanieObiekt binding.value
  2. PytanieArgument dyrektywy
  3. Zadanie z kodemPraktyka: Dyrektywa z argumentem
  4. Ułóż w kolejnościSkładnia dyrektywy z argumentem
  5. PytanieModyfikatory dyrektywy
  6. Zadanie z kodemPraktyka: Dyrektywa z modyfikatorami

Przydatne artykuły