Kurs Vue.js · Moduł 14: Dyrektywy i pluginy
Plugin Ecosystem i Integracja
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 MyPluginComposable vs Plugin - kiedy co stosować?
| Cecha | Composable | Plugin |
|---|---|---|
| Rejestracja | import w komponencie | app.use() w main.js |
| Zasięg | Lokalny (per komponent) | Globalny (cała aplikacja) |
| Globalne komponenty | Nie | Tak (app.component) |
| Globalne dyrektywy | Nie | Tak (app.directive) |
| Provide/Inject | Możliwe | Naturalne |
| Drzewo zależności | Jawne importy | Niejawne (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. Który z poniższych jest oficjalnym pluginem Vue do wielojęzyczności (i18n)?
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:
Zadania po tej lekcji
- PytaniePopularne pluginy Vue
- Pytaniereadonly() w pluginach
- Zadanie z kodemPraktyka: Theme Plugin z opcjami
- Ułóż w kolejnościPrzekazanie readonly ref z pluginu
- PytanieComposable vs Plugin
- Kliknij w kolejnościInstalacja pluginu z opcjami
- Ułóż w kolejnościPlugin Options Pattern
- Ułóż w kolejnościMerge domyślnych opcji
- Ułóż w kolejnościAuto-install pattern
- Kliknij w kolejnościGlobalna dyrektywa w pluginie
- PytanieVeeValidate
- Zadanie z kodemPraktyka: Notification Plugin
- Ułóż w kolejnościArchitektura aplikacji z pluginami
- Ułóż w kolejnościDyrektywa z modyfikatorem w pluginie
- Kliknij w kolejnościRejestracja komponentu w pluginie