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>
<a href="zdjecie.jpg" data-lightbox>
  <img src="miniatura.jpg" alt="…">
</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.

Strona WWW 1
Reklama 1
Strona WWW 2
<!-- 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.

Rozwój projektu 85%
Optymalizacja SEO 60%
Zużycie serwera 92%
<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.

9. Powiązane strony