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

Plugins - Podstawy

2 min czytania ·
W tej lekcji3

W Centrum Dowodzenia NOVA LAB każdy podsystem (nawigacja, komunikacja, diagnostyka) to oddzielny moduł. W Vue takie moduły to Plugins - sposob na dodawanie globalnej funkcjonalności do aplikacji.

Czym jest Plugin?

Plugin to obiekt z metoda install() lub zwykła funkcja. Jest wywoływany przez app.use():

// Plugin jako obiekt
const myPlugin = {
  install(app, options) {
    // tutaj rozszerzamy aplikację
  }
}

// Plugin jako funkcja
function myPlugin(app, options) {
  // również poprawne
}

// Rejestracja
const app = createApp(App)
app.use(myPlugin, { /* opcje */ })

Co może robić Plugin?

W metodzie install() masz dostęp do instancji app i możesz:

1. Rejestrować globalne komponenty

const UIPlugin = {
  install(app) {
    app.component('NovaButton', {
      template: `<button class="nova-btn"><slot /></button>`
    })
    app.component('NovaCard', {
      template: `<div class="nova-card"><slot /></div>`
    })
  }
}

2. Rejestrować globalne dyrektywy

const DirectivesPlugin = {
  install(app) {
    app.directive('focus', {
      mounted(el) { el.focus() }
    })
    app.directive('highlight', (el) => {
      el.style.backgroundColor = '#00ff88'
    })
  }
}

3. Udostępniać dane przez provide/inject

const ConfigPlugin = {
  install(app, options) {
    app.provide('config', {
      apiUrl: options.apiUrl || 'https://api.novalab.mars',
      theme: options.theme || 'dark',
      version: '2.0.87'
    })
  }
}

// Użycie
app.use(ConfigPlugin, {
  apiUrl: 'https://api.novalab.mars/v2',
  theme: 'nova-dark'
})

W dowolnym komponencie:

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

const config = inject('config')
</script>

<template>
  <p>API: {{ config.apiUrl }}</p>
  <p>Wersja: {{ config.version }}</p>
</template>

4. Dodawać globalne właściwości

const UtilsPlugin = {
  install(app) {
    app.config.globalProperties.$formatDate = (date) => {
      return new Date(date).toLocaleDateString('pl-PL')
    }
  }
}

Opcje pluginu

Drugi parametr install() to opcje przekazane przez app.use():

const LoggerPlugin = {
  install(app, options = {}) {
    const level = options.level || 'info'
    const prefix = options.prefix || '[NOVA]'

    app.provide('logger', {
      info: (msg) => level !== 'error' && console.log(prefix, msg),
      warn: (msg) => level !== 'error' && console.warn(prefix, msg),
      error: (msg) => console.error(prefix, msg)
    })
  }
}

app.use(LoggerPlugin, {
  level: 'info',
  prefix: '[NOVA LAB]'
})
Kod do tej lekcji: App.vue
<script setup>
import { inject } from 'vue'

const config = inject('config')
const logger = inject('logger')
</script>

<template>
  <div class="nova-lab">
    <h1>Plugins - Podstawy</h1>

    <section class="section">
      <h2>Config Plugin (provide/inject)</h2>
      <div class="info-grid">
        <div class="info-item">
          <span class="label">API URL:</span>
          <span class="value">{{ config.apiUrl }}</span>
        </div>
        <div class="info-item">
          <span class="label">Theme:</span>
          <span class="value">{{ config.theme }}</span>
        </div>
        <div class="info-item">
          <span class="label">Version:</span>
          <span class="value">{{ config.version }}</span>
        </div>
        <div class="info-item">
          <span class="label">Station:</span>
          <span class="value">{{ config.station }}</span>
        </div>
      </div>
    </section>

    <section class="section">
      <h2>Logger Plugin</h2>
      <div class="btn-row">
        <button @click="logger.info('System operacyjny')" class="btn">Log Info</button>
        <button @click="logger.warn('Niski poziom tlenu')" class="btn warn">Log Warn</button>
        <button @click="logger.error('Awaria silnika!')" class="btn error">Log Error</button>
      </div>
      <p class="hint">Otworz konsole przegladarki (F12) zeby zobaczyc logi</p>
    </section>

    <section class="section">
      <h2>Globalna dyrektywa z pluginu</h2>
      <input v-focus placeholder="Auto-focus z pluginu" class="input" />
    </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;
}
.info-grid { display: grid; gap: 8px; }
.info-item { display: flex; justify-content: space-between; padding: 6px 0; border-bottom: 1px solid rgba(0,180,216,0.1); }
.label { color: #888; }
.value { color: #00ff88; }
.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.warn { color: #f39c12; border-color: #f39c12; background: rgba(243,156,18,0.15); }
.btn.error { color: #e74c3c; border-color: #e74c3c; background: rgba(231,76,60,0.15); }
.input {
  background: rgba(0,255,136,0.05);
  border: 1px solid #00ff88;
  color: #00ff88;
  padding: 10px;
  border-radius: 6px;
  font-family: monospace;
  width: 100%;
  box-sizing: border-box;
}
.input:focus { outline: none; box-shadow: 0 0 8px rgba(0,255,136,0.3); }
.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ą metodę musi posiadać obiekt pluginu Vue?

  2. 2. Jak zainstalować plugin w aplikacji Vue?

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

Zadania praktyczne w grze

  • Układanie w poziomie

    Ułóż poprawne wywołanie app.use z pluginem i opcjami:

  • Edytor kodu

    Użyj app.provide w metodzie install i inject w komponencie.

  • Układanie w pionie

    Ułóż kroki tworzenia i używania pluginu Vue w poprawnej kolejności:

  • Klikanie w kolejności

    Ułóż poprawną sygnaturę metody install pluginu:

  1. PytanieStruktura pluginu Vue
  2. PytanieInstalacja pluginu
  3. Ułóż w kolejnościRejestracja pluginu z opcjami
  4. Zadanie z kodemPraktyka: Config Plugin
  5. PytaniePlugin provide/inject
  6. Ułóż w kolejnościKroki tworzenia pluginu
  7. Kliknij w kolejnościSkładnia metody install

Przydatne artykuły