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

Plugin Ecosystem i Integracja

4 min czytania ·
W tej lekcji5

W NOVA LAB każdy moduł stacji kosmicznej korzysta ze sprawdzonych, przetestowanych systemów - od nawigacji po komunikację. W ekosystemie Vue istnieją popularne pluginy, które rozwiązują typowe problemy. Poznajmy je i nauczmy się tworzyć zaawansowane pluginy.

Popularne pluginy Vue

vue-i18n - internacjonalizacja

vue-i18n to oficjalny plugin do wielojęzyczności w Vue:

import { createI18n } from 'vue-i18n'

const i18n = createI18n({
  locale: 'pl',
  fallbackLocale: 'en',
  messages: {
    pl: {
      station: {
        name: 'Stacja NOVA LAB',
        status: 'Status: {status}',
        crew: 'Załoga: {count} osób'
      }
    },
    en: {
      station: {
        name: 'NOVA LAB Station',
        status: 'Status: {status}',
        crew: 'Crew: {count} members'
      }
    }
  }
})

app.use(i18n)

W komponencie:

<script setup>
import { useI18n } from 'vue-i18n'

const { t, locale } = useI18n()
</script>

<template>
  <h1>{{ t('station.name') }}</h1>
  <p>{{ t('station.status', { status: 'Operacyjny' }) }}</p>
  <button @click="locale = 'en'">EN</button>
  <button @click="locale = 'pl'">PL</button>
</template>

VeeValidate - walidacja formularzy

VeeValidate to plugin do walidacji formularzy:

<script setup>
import { useForm, useField } from 'vee-validate'
import * as yup from 'yup'

const schema = yup.object({
  missionName: yup.string().required('Nazwa misji jest wymagana'),
  crewCount: yup.number().min(1, 'Minimum 1 osoba').required()
})

const { handleSubmit } = useForm({ validationSchema: schema })

const { value: missionName, errorMessage: nameError } = useField('missionName')
const { value: crewCount, errorMessage: crewError } = useField('crewCount')

const onSubmit = handleSubmit(values => {
  console.log('Misja:', values)
})
</script>

<template>
  <form @submit="onSubmit">
    <input v-model="missionName" placeholder="Nazwa misji" />
    <span v-if="nameError">{{ nameError }}</span>

    <input v-model="crewCount" type="number" placeholder="Załoga" />
    <span v-if="crewError">{{ crewError }}</span>

    <button type="submit">Rozpocznij misję</button>
  </form>
</template>

vue-toastification - powiadomienia

vue-toastification to gotowy system powiadomień:

import Toast from 'vue-toastification'
import 'vue-toastification/dist/index.css'

app.use(Toast, {
  position: 'top-right',
  timeout: 3000,
  closeOnClick: true
})

Tworzenie pluginu z provide/inject

Wzorzec provide/inject to najlepszy sposób udostępniania danych z pluginu:

import { ref, readonly } from 'vue'

const NotificationPlugin = {
  install(app, options = {}) {
    const notifications = ref([])
    let nextId = 0

    function notify(message, type = 'info') {
      const id = nextId++
      notifications.value.push({ id, message, type })
      setTimeout(() => {
        notifications.value = notifications.value.filter(n => n.id !== id)
      }, options.duration || 4000)
    }

    app.provide('notifications', {
      list: readonly(notifications),
      notify,
      success: (msg) => notify(msg, 'success'),
      error: (msg) => notify(msg, 'error'),
      warning: (msg) => notify(msg, 'warning')
    })
  }
}

Kluczowy element - readonly() zapobiega przypadkowej modyfikacji listy powiadomień z zewnątrz pluginu.

Plugin Options Pattern

Dobry plugin akceptuje konfigurację z rozsądnymi domyślnymi wartościami:

const ThemePlugin = {
  install(app, options = {}) {
    const defaults = {
      primaryColor: '#00ff88',
      darkMode: true,
      fontFamily: 'monospace',
      borderRadius: '8px'
    }

    const theme = ref({ ...defaults, ...options })

    function setTheme(newOptions) {
      theme.value = { ...theme.value, ...newOptions }
    }

    app.provide('theme', {
      current: readonly(theme),
      setTheme
    })

    // Globalna dyrektywa wykorzystująca theme
    app.directive('themed', (el, binding) => {
      const t = theme.value
      el.style.color = t.primaryColor
      el.style.fontFamily = t.fontFamily
      if (binding.modifiers.bordered) {
        el.style.border = '1px solid ' + t.primaryColor
        el.style.borderRadius = t.borderRadius
      }
    })
  }
}

Instalacja:

app.use(ThemePlugin, {
  primaryColor: '#00b4d8',
  darkMode: true
})

Auto-Install Pattern

Pluginy przeznaczone do dystrybucji (np. jako pakiet npm) powinny wspierać auto-install:

const MyPlugin = {
  install(app, options) {
    // logika pluginu
  }
}

// Auto-install gdy Vue jest dostępne globalnie (CDN)
if (typeof window !== 'undefined' && window.Vue) {
  window.Vue.use(MyPlugin)
}

export default MyPlugin

Composable vs Plugin - kiedy co stosować?

CechaComposablePlugin
Rejestracjaimport w komponencieapp.use() w main.js
ZasięgLokalny (per komponent)Globalny (cała aplikacja)
Globalne komponentyNieTak (app.component)
Globalne dyrektywyNieTak (app.directive)
Provide/InjectMożliweNaturalne
Drzewo zależnościJawne importyNiejawne (inject)

Zasada: Jeżeli funkcjonalność jest potrzebna w wielu miejscach i wymaga globalnej konfiguracji (np. theme, i18n, toast) - użyj pluginu. Jeżeli to logika specyficzna dla kilku komponentów - composable.

Kod do tej lekcji: App.vue
<script setup>
import { inject, ref, readonly } from 'vue'

const theme = inject('theme')
const notifications = inject('notifications')
const { t, locale, setLocale } = inject('i18n')

function testNotification(type) {
  if (type === 'success') {
    notifications.success(t('notifications.saved'))
  } else if (type === 'error') {
    notifications.error(t('notifications.connectionError'))
  } else {
    notifications.notify(t('notifications.scanStarted'))
  }
}
</script>

<template>
  <div class="nova-lab">
    <h1>Plugin Ecosystem i Integracja</h1>

    <section class="section">
      <h2>Theme Plugin (provide/inject + readonly)</h2>
      <div class="theme-info">
        <p>Primary: <span :style="{ color: theme.current.value.primaryColor }">{{ theme.current.value.primaryColor }}</span></p>
        <p>Dark Mode: {{ theme.current.value.darkMode ? 'TAK' : 'NIE' }}</p>
        <p>Font: {{ theme.current.value.fontFamily }}</p>
      </div>
      <div class="btn-row">
        <button @click="theme.setTheme({ primaryColor: '#00ff88' })" class="btn">Zielony</button>
        <button @click="theme.setTheme({ primaryColor: '#00b4d8' })" class="btn cyan">Cyan</button>
        <button @click="theme.setTheme({ primaryColor: '#e74c3c' })" class="btn red">Czerwony</button>
      </div>
    </section>

    <section class="section">
      <h2>i18n Plugin</h2>
      <p>{{ t('station.name') }}</p>
      <p>{{ t('station.status') }}</p>
      <div class="btn-row">
        <button @click="setLocale('pl')" :class="['btn', { active: locale.value === 'pl' }]">PL</button>
        <button @click="setLocale('en')" :class="['btn', { active: locale.value === 'en' }]">EN</button>
      </div>
    </section>

    <section class="section">
      <h2>Notification Plugin</h2>
      <div class="btn-row">
        <button @click="testNotification('success')" class="btn success">Sukces</button>
        <button @click="testNotification('error')" class="btn error">Blad</button>
        <button @click="testNotification('info')" class="btn info">Info</button>
      </div>
    </section>

    <div class="notif-container">
      <div
        v-for="n in notifications.list.value"
        :key="n.id"
        :class="['notif', n.type]"
      >{{ n.message }}</div>
    </div>
  </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;
}
.theme-info { margin-bottom: 10px; }
.theme-info p { margin: 4px 0; font-size: 13px; }
.btn-row { display: flex; gap: 8px; }
.btn {
  background: rgba(0,255,136,0.15);
  color: #00ff88;
  border: 1px solid #00ff88;
  padding: 6px 14px;
  border-radius: 6px;
  cursor: pointer;
  font-family: monospace;
}
.btn.active { background: #00ff88; color: #0a0e27; }
.btn.cyan { color: #00b4d8; border-color: #00b4d8; }
.btn.red { color: #e74c3c; border-color: #e74c3c; }
.btn.success { color: #2ecc71; border-color: #2ecc71; }
.btn.error { color: #e74c3c; border-color: #e74c3c; }
.btn.info { color: #00b4d8; border-color: #00b4d8; }
.notif-container {
  position: fixed; top: 20px; right: 20px;
  display: flex; flex-direction: column; gap: 8px; z-index: 1000;
}
.notif {
  padding: 10px 18px; border-radius: 8px;
  font-family: monospace; font-size: 13px;
  animation: slideIn 0.3s ease;
}
.notif.success { background: rgba(46,204,113,0.9); color: white; }
.notif.error { background: rgba(231,76,60,0.9); color: white; }
.notif.info { background: rgba(0,180,216,0.9); color: white; }
@keyframes slideIn {
  from { transform: translateX(100%); opacity: 0; }
  to { transform: translateX(0); opacity: 1; }
}
</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. Który z poniższych jest oficjalnym pluginem Vue do wielojęzyczności (i18n)?

  2. 2. Po co używać readonly() przy udostępnianiu danych z pluginu?

To 2 z 4 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Edytor kodu

    Zaimplementuj ThemePlugin z domyślnymi opcjami, metodą setTheme i globalną dyrektywą v-themed.

  • Układanie w poziomie

    Ułóż poprawne przekazanie readonly ref przez provide:

  • Klikanie w kolejności

    Ułóż poprawną instalację ThemePlugin z opcjami:

  • Układanie w pionie

    Ułóż kroki implementacji Plugin Options Pattern:

  • Układanie w poziomie

    Ułóż poprawne łączenie domyślnych opcji z przekazanymi:

  • Układanie w pionie

    Ułóż kroki wzorca auto-install pluginu:

  • Klikanie w kolejności

    Ułóż poprawną rejestrację globalnej dyrektywy w pluginie:

  • Edytor kodu

    Zaimplementuj plugin powiadomień z reactive array, setTimeout do auto-remove i provide/inject.

  • Układanie w pionie

    Ułóż warstwy architektury aplikacji Vue z pluginami od najniższej do najwyższej:

  • Układanie w poziomie

    Ułóż użycie dyrektywy v-themed z modyfikatorem bordered:

  • Klikanie w kolejności

    Ułóż poprawną rejestrację globalnego komponentu w pluginie:

  1. PytaniePopularne pluginy Vue
  2. Pytaniereadonly() w pluginach
  3. Zadanie z kodemPraktyka: Theme Plugin z opcjami
  4. Ułóż w kolejnościPrzekazanie readonly ref z pluginu
  5. PytanieComposable vs Plugin
  6. Kliknij w kolejnościInstalacja pluginu z opcjami
  7. Ułóż w kolejnościPlugin Options Pattern
  8. Ułóż w kolejnościMerge domyślnych opcji
  9. Ułóż w kolejnościAuto-install pattern
  10. Kliknij w kolejnościGlobalna dyrektywa w pluginie
  11. PytanieVeeValidate
  12. Zadanie z kodemPraktyka: Notification Plugin
  13. Ułóż w kolejnościArchitektura aplikacji z pluginami
  14. Ułóż w kolejnościDyrektywa z modyfikatorem w pluginie
  15. Kliknij w kolejnościRejestracja komponentu w pluginie

Przydatne artykuły