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

Tworzenie użytecznych pluginów

2 min czytania ·
W tej lekcji3

W NOVA LAB każdy system stacji jest niezależnym modułem. Zobaczmy, jak tworzyć pluginy, które są naprawdę przydatne: toast notifications i i18n (internacjonalizacja).

Toast Plugin - powiadomienia

Toast to krótkie powiadomienie wyświetlane tymczasowo. Plugin dostarczy metodę show() dostępną w całej aplikacji:

const ToastPlugin = {
  install(app, options = {}) {
    const duration = options.duration || 3000
    const position = options.position || 'top-right'

    const toasts = ref([])
    let toastId = 0

    const toast = {
      show(message, type = 'info') {
        const id = toastId++
        toasts.value.push({ id, message, type })
        setTimeout(() => {
          toasts.value = toasts.value.filter(t => t.id !== id)
        }, duration)
      },
      success(msg) { this.show(msg, 'success') },
      error(msg) { this.show(msg, 'error') },
      warning(msg) { this.show(msg, 'warning') },
      list: toasts
    }

    app.provide('toast', toast)
  }
}

Użycie w komponencie:

<script setup>
import { inject } from 'vue'

const toast = inject('toast')

function onSave() {
  toast.success('Dane zapisane!')
}

function onError() {
  toast.error('Błąd połączenia z satelitą!')
}
</script>

i18n Plugin - wielojęzyczność

Plugin do tłumaczenia tekstów na różne języki:

const I18nPlugin = {
  install(app, options) {
    const locale = ref(options.defaultLocale || 'pl')
    const messages = options.messages || {}

    function t(key) {
      const keys = key.split('.')
      let result = messages[locale.value]
      for (const k of keys) {
        result = result?.[k]
      }
      return result || key
    }

    function setLocale(lang) {
      if (messages[lang]) {
        locale.value = lang
      }
    }

    app.provide('i18n', {
      t,
      locale,
      setLocale,
      availableLocales: Object.keys(messages)
    })

    app.directive('t', (el, binding) => {
      el.textContent = t(binding.value)
    })
  }
}

Użycie:

app.use(I18nPlugin, {
  defaultLocale: 'pl',
  messages: {
    pl: {
      nav: { home: 'Strona główna', settings: 'Ustawienia' },
      status: { online: 'Połączony', offline: 'Rozłączony' }
    },
    en: {
      nav: { home: 'Home', settings: 'Settings' },
      status: { online: 'Connected', offline: 'Disconnected' }
    }
  }
})

W komponencie:

<script setup>
import { inject } from 'vue'
const { t, setLocale, locale } = inject('i18n')
</script>

<template>
  <nav>
    <a>{{ t('nav.home') }}</a>
    <a>{{ t('nav.settings') }}</a>
  </nav>
  <p>Status: {{ t('status.online') }}</p>
  <button @click="setLocale('en')">EN</button>
  <button @click="setLocale('pl')">PL</button>
</template>

Wzorce dobrych pluginów

  1. Provide/Inject - preferuj nad globalProperties
  2. Opcje z domyślnymi wartościami - plugin musi działać bez konfiguracji
  3. Typowanie - eksportuj interfejsy dla TypeScript
  4. Czystka - jeżeli plugin modyfikuje DOM, zadbaj o cleanup
  5. Dokumentacja - opisz dostępne opcje i metody
Kod do tej lekcji: App.vue
<script setup>
import { inject, ref } from 'vue'

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

function showSuccess() {
  toast.success(t('toast.saved'))
}
function showError() {
  toast.error(t('toast.connectionError'))
}
function showWarning() {
  toast.warning(t('toast.lowOxygen'))
}
</script>

<template>
  <div class="nova-lab">
    <h1>{{ t('title') }}</h1>

    <section class="section">
      <h2>Toast Plugin</h2>
      <div class="btn-row">
        <button @click="showSuccess" class="btn success">{{ t('toast.successBtn') }}</button>
        <button @click="showError" class="btn error">{{ t('toast.errorBtn') }}</button>
        <button @click="showWarning" class="btn warn">{{ t('toast.warnBtn') }}</button>
      </div>
    </section>

    <section class="section">
      <h2>i18n Plugin</h2>
      <p>{{ t('status.label') }}: {{ t('status.online') }}</p>
      <p>{{ t('crew.label') }}: {{ t('crew.count') }}</p>
      <div class="btn-row" style="margin-top: 10px">
        <button
          @click="setLocale('pl')"
          :class="['btn', { active: locale === 'pl' }]"
        >PL</button>
        <button
          @click="setLocale('en')"
          :class="['btn', { active: locale === 'en' }]"
        >EN</button>
      </div>
      <p class="hint">Przelacz jezyk i zobacz jak zmieniaja sie teksty</p>
    </section>

    <!-- Toast container -->
    <div class="toast-container">
      <div
        v-for="t in toast.list.value"
        :key="t.id"
        :class="['toast', t.type]"
      >
        {{ t.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;
}
.btn-row { display: flex; gap: 10px; }
.btn {
  background: rgba(0,255,136,0.15);
  color: #00ff88;
  border: 1px solid #00ff88;
  padding: 8px 16px;
  border-radius: 6px;
  cursor: pointer;
  font-family: monospace;
}
.btn.active { background: #00ff88; color: #0a0e27; }
.btn.success { color: #2ecc71; border-color: #2ecc71; }
.btn.error { color: #e74c3c; border-color: #e74c3c; }
.btn.warn { color: #f39c12; border-color: #f39c12; }
.toast-container {
  position: fixed; top: 20px; right: 20px;
  display: flex; flex-direction: column; gap: 8px;
  z-index: 1000;
}
.toast {
  padding: 12px 20px;
  border-radius: 8px;
  font-family: monospace;
  font-size: 14px;
  animation: slideIn 0.3s ease;
}
.toast.success { background: rgba(46,204,113,0.9); color: white; }
.toast.error { background: rgba(231,76,60,0.9); color: white; }
.toast.warning { background: rgba(243,156,18,0.9); color: white; }
.toast.info { background: rgba(0,180,216,0.9); color: white; }
@keyframes slideIn {
  from { transform: translateX(100%); opacity: 0; }
  to { transform: translateX(0); opacity: 1; }
}
.hint { color: #666; font-size: 12px; margin-top: 8px; }
</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. Jak zrealizować automatyczne znikanie toastów po 3 sekundach?

  2. 2. Co robi funkcja t('nav.home') w pluginie i18n?

Zadania praktyczne w grze

  • Układanie w pionie

    Ułóż kroki działania metody toast.show() w poprawnej kolejności:

  • Edytor kodu

    Zaimplementuj ToastPlugin z reaktywną tablicą toastów i metodami show/success/error.

  • Klikanie w kolejności

    Ułóż poprawną składnię app.provide w pluginie:

  • Układanie w poziomie

    Ułóż poprawne wywołanie inject do pobrania toastu:

  1. PytanieToast plugin - czas wyświetlania
  2. Ułóż w kolejnościDziałanie metody toast.show()
  3. Zadanie z kodemPraktyka: Toast Plugin
  4. Pytaniei18n Plugin - funkcja t()
  5. Kliknij w kolejnościUżycie provide w pluginie
  6. Ułóż w kolejnościWywołanie inject w komponencie

Przydatne artykuły