Karuzele & Lightbox
Sześć komponentów multimedialnych i prezentacji postępu.
Karuzela stoi na natywnym scroll-snap - płynna na
dotyku, bez bibliotek typu Slick czy Swiper. Pasek na samej
górze tej strony to żywy przykład paska czytania - przewiń,
żeby zobaczyć.
1. Co wybrać
| Komponent | Kiedy | Na czym stoi |
|---|---|---|
.carousel |
Kilka kart/slajdów do przewijania w poziomie. | scroll-snap + JS (strzałki, kropki) |
.carousel-bg-sync |
Hero z pełnoekranowym tłem zmieniającym się per slajd. | To samo co karuzela + IntersectionObserver |
[data-lightbox] |
Powiększanie zdjęć na pełny ekran z galerii miniatur. | JS buduje cały modal - Ty piszesz tylko atrybuty |
.nav-filters |
Filtrowanie siatki elementów (portfolio, galeria) bez przeładowania. | JS + klasy stanu (.is-hidden) |
.progress |
Pojedynczy pasek postępu ze statyczną wartością (umiejętności, statystyki). | Czysty CSS, wartość przez style="width:…" |
.progress-container-fixed |
Pasek postępu CZYTANIA całej strony, przyklejony u góry. | Rdzeń molique-script.js, nasłuch scrolla |
2. Karuzela
Szerokość pojedynczego slajdu ustawiasz sam przez CSS
(min-width: 100% - jeden slajd na ekran,
50% - dwa naraz, itd.). Skrypt dolicza resztę:
generuje kropki paginacji (o ile slajdów jest więcej niż
jeden i sam ich nie dostarczysz), obsługuje strzałki i
podświetla aktywną kropkę przez IntersectionObserver.
<div class="carousel">
<button class="carousel-nav carousel-prev">‹</button>
<button class="carousel-nav carousel-next">›</button>
<div class="carousel-track">
<!-- min-width steruje iloma slajdow widac naraz -->
<div class="carousel-slide" style="min-width: 100%;">
<div class="card">Treść slajdu 1</div>
</div>
<div class="carousel-slide" style="min-width: 100%;">
<div class="card">Treść slajdu 2</div>
</div>
</div>
</div>
<!-- .carousel-dots wygeneruje się sam pod spodem -->
| Klasa | Co robi |
|---|---|
.carousel |
Obudowa. position: relative - kotwica dla strzałek. |
.carousel-track |
overflow-x: auto; scroll-snap-type: x mandatory; - realny mechanizm przewijania. |
.carousel-slide |
scroll-snap-align: start. Szerokość - Twoja, przez min-width. |
.carousel-nav / -prev / -next |
Okrągłe strzałki. Opcjonalne - bez nich karuzela nadal działa gestem/scrollem. |
.carousel-dots / .carousel-dot |
Generowane przez skrypt automatycznie, gdy slajdów jest
więcej niż jeden i nie ma jeszcze
.carousel-dots w markupie. Aktywna kropka
dostaje .is-active.
|
3. Karuzela Hero (Background Sync)
Wariant, w którym tło całego kontenera płynnie zmienia się
wraz z aktualnie widocznym slajdem - ten sam
IntersectionObserver, który podświetla kropki,
ustawia też background-image kontenera na
podstawie data-bg aktywnego slajdu.
<div class="carousel carousel-bg-sync">
<div class="carousel-bg-overlay"></div>
<div class="carousel-track">
<!-- data-bg definiuje tło TEGO konkretnego slajdu -->
<div class="carousel-slide" data-bg="img/slide1.jpg">
<h2>Nagłówek 1</h2>
</div>
<div class="carousel-slide" data-bg="img/slide2.jpg">
<h2>Nagłówek 2</h2>
</div>
</div>
</div>
| Klasa / atrybut | Co robi |
|---|---|
.carousel-bg-sync |
Modyfikator na .carousel. Ustawia minimalną wysokość i przygotowuje tło pod background-image. |
data-bg |
Na każdym .carousel-slide - adres zdjęcia
tła dla TEGO slajdu. Bez niego tło po prostu nie
zmieni się przy wejściu na dany slajd (zostaje
poprzednie).
|
.carousel-bg-overlay |
Półprzezroczysta nakładka nad tłem - zapewnia czytelność tekstu. |
Strzałki tylko na hover
W tym wariancie strzałki nawigacji są niewidoczne, dopóki kursor nie znajdzie się nad karuzelą - spójne z pełnoekranowym, „czystym" charakterem sekcji hero. Na dotyku pozostają niewidoczne (nawigacja to wtedy gest przesunięcia).
4. Galeria Lightbox
Cały modal (tło, licznik, strzałki, przycisk zamknięcia) buduje
skrypt sam przy pierwszym użyciu - nie piszesz
żadnej z klas .lightbox-* ręcznie. Twój markup to
wyłącznie linki z dwoma atrybutami danych.
<!-- data-lightbox aktywuje skrypt, data-gallery grupuje zdjęcia -->
<a href="duze-1.jpg" data-lightbox data-gallery="realizacje">
<img src="miniatura-1.jpg" alt="Foto 1">
</a>
<a href="duze-2.jpg" data-lightbox data-gallery="realizacje">
<img src="miniatura-2.jpg" alt="Foto 2">
</a>
| Atrybut | Co robi |
|---|---|
data-lightbox |
Na <a>. Uruchamia skrypt; href linku to zdjęcie w pełnym rozmiarze. |
data-gallery |
Łączy linki o tej samej wartości w jedną galerię z licznikiem i strzałkami. Bez niego każdy link to osobna, jednoelementowa „galeria". |
Nawigacja: myszka, dotyk, klawiatura
Strzałki na ekranie, przeciąganie (swipe) na dotyku, oraz - wewnątrz otwartego modala - ←/→ do zmiany zdjęcia i Esc do zamknięcia. Focus przy otwarciu przeskakuje na przycisk zamknięcia i wraca do klikniętej miniatury po zamknięciu.
Struktura wygenerowanego modala
Nie piszesz tych klas w swoim HTML (patrz pułapka nr 2), ale przydają się, gdy chcesz nadpisać wygląd modala własnym CSS.
| Klasa | Co to |
|---|---|
.lightbox-overlay |
Całe ciemne tło modala. |
.lightbox-content |
Wrapper wokół powiększonego zdjęcia. |
.lightbox-top-bar |
Górny pasek z licznikiem i przyciskiem zamknięcia. |
.lightbox-counter |
Tekst „2 / 5". Ukryty, gdy galeria ma tylko jedno zdjęcie. |
.lightbox-close |
Przycisk × w prawym górnym rogu. |
.lightbox-nav / -prev / -next |
Strzałki po bokach. Też ukryte przy jednoelementowej galerii. |
5. Filtry portfolio
Menu filtrujące siatkę elementów bez przeładowania strony i bez zapytań do serwera - czysta manipulacja klasami w DOM.
<!-- Menu filtrów -->
<ul class="nav-filters">
<li><button class="is-active" data-filter="all">Wszystkie</button></li>
<li><button data-filter="www">Strony www</button></li>
</ul>
<!-- Kontener elementów - MUSI być zaraz pod menu, patrz pułapka nr 1 -->
<div class="grid-auto">
<div class="filter-item" data-category="www">Projekt 1</div>
<div class="filter-item" data-category="ads">Projekt 2</div>
</div>
| Klasa / atrybut | Co robi |
|---|---|
.nav-filters |
Na <ul>. Przyciski wewnątrz - dowolna ich liczba. |
data-filter |
Na każdym przycisku. Wartość "all" pokazuje wszystko, inna - tylko pasującą kategorię. |
.filter-item / data-category |
Na każdym filtrowanym elemencie. Wartość data-category porównywana jest z data-filter klikniętego przycisku. |
.is-hidden / .is-animated |
Nadaje skrypt. .is-hidden chowa
niepasujący element (display: none);
.is-animated odtwarza krótkie „wskoczenie"
pasujących elementów.
|
6. Paski postępu
Statyczny pasek do prezentacji wartości - umiejętności, statystyki, wykorzystanie zasobu. Zero JS.
<div class="progress-label">
<span>Rozwój projektu</span>
<span>85%</span>
</div>
<div class="progress">
<div class="progress-bar bg-success" style="width: 85%;"></div>
</div>
| Klasa | Co robi |
|---|---|
.progress |
Tor paska - cienki, zaokrąglony, overflow: hidden. |
.progress-bar |
Wypełnienie. Szerokość przez
style="width: X%". Kolor - dowolna klasa
tła (.bg-success, .bg-danger…).
|
.progress-label |
Wiersz etykieta + wartość nad paskiem. Opcjonalny. |
7. Pasek czytania
Cienki pasek przyklejony do góry ekranu, rosnący wraz z
przewijaniem. Ten na samej górze tej strony jest prawdziwy -
obsługa mieszka na stałe w rdzeniu molique-script.js
(jak przełącznik sidebara w panelu admina), nie w osobnym module.
<!-- Tuż po otwarciu <body>, przed resztą treści -->
<div class="progress-container-fixed">
<div class="progress-bar-reading"></div>
</div>
| Klasa | Co robi |
|---|---|
.progress-container-fixed |
position: fixed, góra ekranu, ponad nawigacją. Sam w sobie niewidoczny (tło przezroczyste). |
.progress-bar-reading |
Faktyczny pasek. Szerokość aktualizowana w requestAnimationFrame proporcjonalnie do pozycji scrolla. |
8. Pułapki
1
Kontener .filter-item w złym miejscu w DOM
Skrypt szuka elementów do filtrowania przez
navFilters.nextElementSibling - kontener z
.filter-item musi być
bezpośrednim sąsiadem
.nav-filters w kodzie, zaraz po nim. Wstawienie
czegokolwiek pomiędzy (np. akapitu z opisem) sprawia, że
przyciski przestają cokolwiek filtrować, bez błędu w konsoli.
2
Ręczne pisanie klas .lightbox-*
Cały modal lightboksa (.lightbox-overlay,
.lightbox-content, przyciski…) tworzy skrypt
przy pierwszym kliknięciu w [data-lightbox] i
dokleja na końcu <body>. Pisanie tej
struktury ręcznie w HTML nic nie daje - a jeśli
przypadkiem nada się klasę .lightbox-overlay
czemuś innemu, skrypt uzna to za już istniejący modal i
zacznie się do niego dopisywać.
3
.progress-bar i .progress-bar-reading animują width
Oba komponenty przechodzą transition na
właściwości width - wygodne (szerokość to
naturalna miara procentu), ale to jedna z nielicznych
świadomych odstępstw od reguły „animuj wyłącznie
transform/opacity" w tym
frameworku: przy bardzo częstych aktualizacjach (pasek
czytania przy szybkim scrollu) może to kosztować więcej
klatek niż odpowiednik na transform: scaleX().
W praktyce przy pojedynczym pasku efekt jest
niezauważalny - warto o tym pamiętać dopiero przy wielu
animowanych paskach naraz na jednym ekranie.
4
Slajd bez data-bg w wariancie Background Sync
Jeśli konkretny .carousel-slide nie ma
atrybutu data-bg, wejście na niego NIE
czyści tła - zostaje obraz poprzedniego slajdu. Jeśli
chcesz świadomie pustego tła na którymś slajdzie, ustaw
data-bg="" jawnie zamiast pomijać atrybut.