Kurs Vue.js · Moduł 6: Komponenty
Style Scoped i CSS Modules
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. Co robi atrybut scoped w <style>?
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: