Kurs Vue.js · Moduł 6: Komponenty

Style Scoped i CSS Modules

5 min czytania ·
W tej lekcji5

Izolacja stylów w komponentach działa jak grodzie między modułami habitatu - to, co dzieje się w jednym przedziale, nie przedostaje się do sąsiednich.

Dwa komponenty w bazie mają klasę .card: jeden to karta modułu, drugi karta członka załogi. Zwykły CSS działa na całej stronie, więc reguła zapisana w jednym pliku przemaluje karty w obu. Vue daje kilka poziomów izolacji i dziś poznasz każdy z nich.

Scoped Styles

Atrybut scoped znasz ze Strefy Startowej: reguły z takiego bloku obowiązują tylko w elementach bieżącego komponentu. Zacznijmy od karty, której style nie wyciekną poza plik:

<template>
  <div class="card">
    <h3 class="title">{{ title }}</h3>
  </div>
</template>

<style scoped>
/* Tylko dla tego komponentu */
.card {
  border: 1px solid #ccc;
  padding: 1rem;
}

.title {
  color: #333;
}
</style>

Vue dodaje każdemu elementowi komponentu atrybut w rodzaju data-v-7ba5bd90, a selektor .card zamienia na .card[data-v-7ba5bd90]. Karta członka załogi w innym pliku dostaje inny atrybut, więc ta reguła jej nie dotknie. Jest jeden celowy wyjątek: element główny komponentu dziecka podlega zarówno stylom dziecka, jak i scoped stylom rodzica, żeby rodzic mógł go ustawić w swoim układzie.

:deep() - wgląd do wnętrza dziecka

Czasem rodzic musi jednak ostylować element położony głębiej w komponencie dziecka. Do tego służy pseudoselektor :deep():

<style scoped>
/* Deep selector - wpływ na child komponenty */
.card :deep(.child-class) {
  color: blue;
}
</style>

Kompilator zamienia tę regułę na .card[data-v-7ba5bd90] .child-class. Atrybut zostaje tylko przy .card, więc .child-class pasuje także do elementów wewnątrz dzieci. Starsze zapisy >>> i /deep/ pochodzą z Vue 2 - kompilator Vue 3 wciąż je rozumie, ale ostrzega, że są przestarzałe, i każe użyć :deep().

:slotted() i :global()

Dwa kolejne pseudoselektory dotyczą treści spoza komponentu. Slot to miejsce w szablonie dziecka, w które rodzic wkłada własną treść - poznasz go w Magazynie Modułów. Taka treść należy do rodzica, więc scoped style dziecka domyślnie jej nie obejmują:

<style scoped>
/* Slotted content */
:slotted(.slot-class) {
  font-weight: bold;
}

/* Global w scoped */
:global(.global-class) {
  background: yellow;
}
</style>

:slotted() kieruje regułę do treści wstawionej przez slot, a :global() wyłącza izolację dla jednej reguły, więc .global-class zadziała na całej stronie. Z globalnych reguł w scoped korzystaj oszczędnie, bo to otwarte drzwi w grodzi.

CSS Modules

Drugi sposób izolacji to CSS Modules. Blok <style module> zamienia każdą klasę na unikalną, wygenerowaną nazwę, a w szablonie sięgasz po nią przez obiekt $style i dyrektywę :class:

<template>
  <div :class="$style.card">
    <h3 :class="$style.title">{{ title }}</h3>
    <p :class="[$style.text, $style.highlighted]">Opis</p>
  </div>
</template>

<style module>
.card {
  border: 1px solid #ccc;
}

.title {
  color: #333;
}

.text {
  font-size: 14px;
}

.highlighted {
  background: yellow;
}
</style>

Nawiasy kwadratowe nakładają dwie klasy naraz, bo :class przyjmuje też tablicę. Klasa card z tego pliku nie ma nic wspólnego z card w innym komponencie - obie dostaną różne nazwy. Różnica wobec scoped polega na tym, że izolacja działa przez nazwy klas, a nie atrybuty, i obejmuje tylko elementy, którym jawnie przypiszesz klasę z $style. Wygenerowane nazwy odczytasz też w skrypcie funkcją useCssModule:

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

const styles = useCssModule()
console.log(styles.card) // np. "_card_1a2b3_2" - nazwę generuje Vite
</script>

Format nazwy zależy od konfiguracji narzędzia budującego - Vite domyślnie łączy nazwę klasy, skrót zawartości i numer linii. Blok może też dostać własną nazwę, na przykład <style module="classes">, a wtedy w szablonie piszesz classes.card.

Dynamiczne Style

Czasem kolor ma zależeć od danych, na przykład od typu modułu. Dyrektywa :style przyjmuje obiekt, a jego kluczami mogą być także zmienne CSS, czyli właściwości zaczynające się od dwóch myślników:

<template>
  <div
    class="card"
    :style="{
      '--primary-color': primaryColor,
      '--border-width': borderWidth + 'px'
    }"
  >
    <h3>{{ title }}</h3>
  </div>
</template>

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

const primaryColor = ref('#8b7355')
const borderWidth = ref(2)
</script>

<style scoped>
.card {
  border: var(--border-width) solid var(--primary-color);
  color: var(--primary-color);
}
</style>

Komponent ustawia zmienne --primary-color i --border-width na swoim elemencie, a reguła w <style scoped> odczytuje je funkcją var(). Arkusz się nie zmienia - zmieniają się tylko wartości zmiennych, gdy zmienią się kontenery ref().

v-bind() w CSS

Vue potrafi to samo prościej: funkcja v-bind() wpisana wprost w regułę CSS wiąże wartość z kontenerem z <script setup>:

<template>
  <div class="card">
    <input v-model="color" type="color" />
    <p>Ten tekst zmienia kolor!</p>
  </div>
</template>

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

const color = ref('#8b7355')
</script>

<style scoped>
p {
  /* Reaktywne wiązanie! */
  color: v-bind(color);
}
</style>

Wybierz kolor w polu, a tekst natychmiast go przyjmie. Kompilator zamienia v-bind(color) na zmienną CSS o unikalnej nazwie, którą Vue ustawia na elemencie głównym komponentu i aktualizuje przy każdej zmianie, więc sam arkusz pozostaje statyczny.

Poziomy Izolacji

Od najszerszego do najwęższego zasięgu: style globalne bez scoped działają na całej stronie, <style scoped> na elementach jednego komponentu, CSS Modules tylko na elementach z klasą z $style, a styl inline przez :style na jednym konkretnym elemencie. W NOVA LAB domyślnie piszemy <style scoped>, a po CSS Modules sięgamy, gdy nazwy klas są potrzebne w skrypcie - taki punkt wyjścia polecam Ci.

W edytorze poniżej każdy komponent panelu ustawień materiałów ma własny blok <style scoped>. Zmień kolor w jednym pliku i sprawdź, że drugi pozostaje bez zmian. Panel korzysta też z v-model na komponentach, które poznasz w Stacji Komunikacji.

Zapamiętaj: scoped stawia grodzie wokół modułu, CSS Modules nadają klasom unikalne nazwy, a v-bind() w CSS podłącza wygląd prosto do danych misji.

Kod do tej lekcji: App.vue
<script setup>
import { ref } from 'vue'
import MaterialSettings from './MaterialSettings.vue'

const printSettings = ref({
  material: 'PLA',
  temperature: 210,
  speed: 50,
  layerHeight: 0.2
})

const extruderSettings = ref({
  flowRate: 100,
  retraction: 5
})

function savePrintSettings() {
  console.log('Zapisano ustawienia druku:', printSettings.value)
  alert('Ustawienia zapisane!')
}

function saveExtruderSettings() {
  console.log('Zapisano ustawienia ekstrudera:', extruderSettings.value)
  alert('Ustawienia ekstrudera zapisane!')
}
</script>

<template>
  <div class="settings-lab">
    <div class="header">
      <h1>Ustawienia Materiałów - NOVA LAB</h1>
      <p class="subtitle">Component v-model</p>
    </div>

    <div class="info-panel">
      <h3>v-model w komponentach</h3>
      <p><strong>v-model</strong> to skrót dla :modelValue + @update:modelValue</p>
      <p>Możesz użyć wielu v-model z różnymi nazwami: v-model:customName</p>
      <code class="code-example">
<!-- W komponencie rodzica -->
v-model="value"
v-model:customName="otherValue"

<!-- W komponencie dziecka -->
defineProps(['modelValue', 'customName'])
emit('update:modelValue', newValue)
emit('update:customName', newValue)
      </code>
    </div>

    <div class="settings-grid">
      <!-- Single v-model -->
      <div class="settings-card">
        <h2>Podstawowe ustawienia druku</h2>
        <MaterialSettings v-model="printSettings" />

        <div class="preview-section">
          <h4>Podgląd wartości:</h4>
          <pre>{{ JSON.stringify(printSettings, null, 2) }}</pre>
          <button @click="savePrintSettings" class="btn btn-save">
            Zapisz ustawienia
          </button>
        </div>
      </div>

      <!-- Multiple v-models -->
      <div class="settings-card">
        <h2>Ustawienia ekstrudera</h2>
        <MaterialSettings
          v-model="extruderSettings"
          :show-advanced="true"
        />

        <div class="preview-section">
          <h4>Podgląd wartości:</h4>
          <pre>{{ JSON.stringify(extruderSettings, null, 2) }}</pre>
          <button @click="saveExtruderSettings" class="btn btn-save">
            Zapisz ustawienia ekstrudera
          </button>
        </div>
      </div>

      <!-- Direct input with v-model -->
      <div class="settings-card">
        <h2>Edycja manualna (JSON)</h2>
        <textarea
          v-model="printSettings.material"
          class="json-editor"
          placeholder="Edytuj nazwę materiału..."
        ></textarea>
        <p class="info-text">
          Zmiany w polu tekstowym automatycznie aktualizują obiekt printSettings
        </p>
      </div>
    </div>

    <div class="summary-panel">
      <h2>Podsumowanie wszystkich ustawień</h2>
      <div class="summary-grid">
        <div class="summary-item">
          <h4>Ustawienia druku</h4>
          <ul>
            <li>Materiał: <strong>{{ printSettings.material }}</strong></li>
            <li>Temperatura: <strong>{{ printSettings.temperature }}°C</strong></li>
            <li>Prędkość: <strong>{{ printSettings.speed }}%</strong></li>
            <li>Wysokość warstwy: <strong>{{ printSettings.layerHeight }}mm</strong></li>
          </ul>
        </div>
        <div class="summary-item">
          <h4>Ustawienia ekstrudera</h4>
          <ul>
            <li>Przepływ: <strong>{{ extruderSettings.flowRate }}%</strong></li>
            <li>Retrakcja: <strong>{{ extruderSettings.retraction }}mm</strong></li>
          </ul>
        </div>
      </div>
    </div>
  </div>
</template>

<style scoped>
.settings-lab {
  background: linear-gradient(135deg, #0a0e27 0%, #1a1e3f 100%);
  min-height: 100vh;
  padding: 2rem;
  color: #ffffff;
  font-family: 'Courier New', monospace;
}

.header {
  text-align: center;
  margin-bottom: 2rem;
  padding-bottom: 1rem;
  border-bottom: 2px solid #00ff88;
}

.header h1 {
  font-size: 2.5rem;
  color: #00ff88;
  text-shadow: 0 0 20px rgba(0, 255, 136, 0.5);
  margin: 0;
}

.subtitle {
  color: #00b4d8;
  font-size: 1.2rem;
  margin-top: 0.5rem;
}

.info-panel {
  background: rgba(0, 180, 216, 0.1);
  border: 2px solid #00b4d8;
  border-radius: 10px;
  padding: 1.5rem;
  margin-bottom: 2rem;
}

.info-panel h3 {
  color: #00b4d8;
  margin-top: 0;
}

.info-panel strong {
  color: #00ff88;
}

.code-example {
  display: block;
  background: rgba(0, 0, 0, 0.5);
  border-left: 4px solid #00ff88;
  padding: 1rem;
  border-radius: 5px;
  color: #00ff88;
  margin-top: 1rem;
  white-space: pre;
  overflow-x: auto;
}

.settings-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(400px, 1fr));
  gap: 1.5rem;
  margin-bottom: 2rem;
}

.settings-card {
  background: rgba(0, 255, 136, 0.05);
  border: 2px solid #00ff88;
  border-radius: 10px;
  padding: 1.5rem;
}

.settings-card h2 {
  color: #00ff88;
  margin-top: 0;
  margin-bottom: 1.5rem;
}

.preview-section {
  margin-top: 1.5rem;
  padding-top: 1.5rem;
  border-top: 2px solid rgba(0, 255, 136, 0.2);
}

.preview-section h4 {
  color: #00b4d8;
  margin-top: 0;
}

.preview-section pre {
  background: rgba(0, 0, 0, 0.5);
  padding: 1rem;
  border-radius: 5px;
  color: #00ff88;
  overflow-x: auto;
  border-left: 4px solid #00ff88;
}

.json-editor {
  width: 100%;
  min-height: 150px;
  background: rgba(0, 0, 0, 0.3);
  border: 2px solid #00b4d8;
  border-radius: 5px;
  padding: 1rem;
  color: #ffffff;
  font-family: 'Courier New', monospace;
  resize: vertical;
}

.json-editor:focus {
  outline: none;
  border-color: #00ff88;
  box-shadow: 0 0 10px rgba(0, 255, 136, 0.3);
}

.info-text {
  color: #00b4d8;
  font-size: 0.9rem;
  margin-top: 1rem;
}

.btn-save {
  background: #00ff88;
  color: #0a0e27;
  border: none;
  padding: 0.75rem 1.5rem;
  border-radius: 5px;
  font-weight: bold;
  cursor: pointer;
  transition: all 0.3s ease;
  font-family: 'Courier New', monospace;
  margin-top: 1rem;
}

.btn-save:hover {
  transform: scale(1.05);
  box-shadow: 0 5px 15px rgba(0, 255, 136, 0.4);
}

.summary-panel {
  background: rgba(0, 180, 216, 0.1);
  border: 2px solid #00b4d8;
  border-radius: 10px;
  padding: 1.5rem;
}

.summary-panel h2 {
  color: #00b4d8;
  margin-top: 0;
}

.summary-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
  gap: 1.5rem;
}

.summary-item {
  background: rgba(0, 0, 0, 0.3);
  padding: 1.5rem;
  border-radius: 8px;
  border-left: 4px solid #00ff88;
}

.summary-item h4 {
  color: #00ff88;
  margin-top: 0;
}

.summary-item ul {
  list-style: none;
  padding: 0;
}

.summary-item li {
  padding: 0.5rem 0;
  color: #ffffff;
  border-bottom: 1px solid rgba(0, 255, 136, 0.1);
}

.summary-item li:last-child {
  border-bottom: none;
}

.summary-item strong {
  color: #00b4d8;
}
</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 robi atrybut scoped w <style>?

  2. 2. Jak stylować komponenty potomne w scoped styles?

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

Zadania praktyczne w grze

  • Edytor kodu

    Dodaj scoped styles do MarsPanel.vue z klasami dla panelu (.panel), tytułu (.title) i statusu (.status).

  • Klikanie w kolejności

    Ułóż elementy deklaracji scoped style:

  • Układanie w pionie

    Ułóż kroki tworzenia komponentu od początku do użycia:

  1. PytanieAtrybut scoped w style
  2. PytanieDeep selectors w scoped styles
  3. Zadanie z kodemPraktyka: Scoped styles
  4. Kliknij w kolejnościDeklaracja scoped style
  5. PytanieWłączenie CSS Modules
  6. Ułóż w kolejnościTworzenie kompletnego komponentu

Przydatne artykuły