Skrypt konwertujący rzędy Divi w slider – przenikanie (fade) zgodne z WCAG

Aleksandra Głaz
23 października, 2026

Czasami potrzebny jest slider, który nie ogranicza Cię do prostych, jednolitych „kart” — chcesz zbudować każdy slajd tak swobodnie, jak zwykłą sekcję w Divi, łącznie z nakładającymi się kolumnami czy zaawansowanym układem. Ten wpis pokazuje rozwiązanie odwrotne niż zwykle: zamiast wtłaczać treść w gotową strukturę slidera, budujesz ją normalnie w Divi Builderze, a skrypt JavaScript przechwytuje gotowe rzędy i zamyka je w slider z efektem przenikania (fade), zachowując pełną zgodność z WCAG.

Jak to działa

Skrypt wykorzystuje bibliotekę Swiper.js, ale w nietypowy sposób: zamiast z góry zdefiniowanej struktury swiper-slide, buduje ją dynamicznie w przeglądarce z istniejących rzędów Divi.

A. Manipulacja DOM przez przenoszenie węzłów. Skrypt znajduje wszystkie rzędy z klasą .divi-slide-row, tworzy wirtualną strukturę div.swiper, a następnie metodą appendChild przenosi (nie klonuje) fizyczne węzły rzędów do wygenerowanych slajdów. To ważne rozróżnienie: przeniesienie zachowuje wszystkie event-listenery JavaScript, które Divi już podpięło pod te moduły — klonowanie by je utraciło.

B. Rozwiązanie konfliktu z efektem Fade. Typowy problem przy łączeniu efektu fade z niestandardowym CSS to widoczny „przeskok” przy pierwszym kliknięciu, gdy ręczne modyfikacje opacity w CSS kolidują z tym, jak Swiper.js zarządza przenikaniem wewnętrznie. Rozwiązanie: żadnych ręcznych modyfikacji opacity w CSS — cały mechanizm przenikania zostaje w rękach crossFade: true w konfiguracji Swiper.js.

C. Zabezpieczenie przed Visual Builderem. Skrypt sprawdza, czy strona jest renderowana wewnątrz wizualnego edytora Divi (et-fb-root-ancestor) i jeśli tak — przerywa działanie. Bez tego zabezpieczenia próba przenoszenia węzłów DOM w trakcie edycji wizualnej mogłaby zaburzyć pracę w Builderze.

Dostępność (WCAG) w praktyce

  • Moduł a11y Swiper.js — pełne wsparcie dla czytników ekranu, z polskimi komunikatami: poprzedni/następny slajd, pierwszy/ostatni slajd, numer aktualnego slajdu.
  • Nawigacja klawiaturą ograniczona do widocznego obszaru (keyboard.onlyInViewport: true).
  • Fokus klawiatury — wyraźny obrys :focus-visible na kropkach paginacji i strzałkach nawigacji.
  • Responsywne strzałki nawigacji. Na pulpicie odsunięte 6% od krawędzi (nie nakładają się na standardowy 80% rząd Divi). Na tabletach przysunięte do 2% i nieco mniejsze. Na telefonach całkowicie ukryte — na ekranach dotykowych naturalnym gestem jest przesunięcie palcem (swipe), a widoczne strzałki tylko zajmowałyby miejsce.
  • autoHeight: true — slider dopasowuje wysokość do zawartości aktualnego rzędu, więc żaden fragment treści nie zostaje ucięty niezależnie od tego, jak różne wysokości mają Twoje rzędy.
  • Opcjonalny autoplay z ikonowym przyciskiem pauzy (WCAG 2.2.2). Domyślnie slider się nie przewija — jeśli włączysz automatyczne przewijanie (sekcja niżej), dochodzi widoczny przycisk pauzy z aktualizującym się aria-label i minimalnym obszarem klikalnym 44×44px.

Instrukcja wdrożenia w Divi

  1. Zbuduj swoje rzędy normalnie w Divi Builderze — najlepiej, żeby miały zbliżoną szerokość.
  2. W każdym rzędzie, który ma być częścią slidera: Ustawienia Rzędu → Zaawansowane → Identyfikatory i klasy CSS → w polu Klasa CSS wpisz divi-slide-row.
  3. Pod ostatnim rzędem dodaj moduł Kod (Code).
  4. Wklej do niego kod poniżej.

Demo

Poniższe demo pokazuje mechanizm na trzech kolorowych, symulowanych rzędach — dokładnie ten sam skrypt, który wklejasz w Divi, tyle że rzędy są tu zastąpione prostymi blokami kolorystycznymi zamiast Twojej rzeczywistej treści.

Twój Rząd Divi nr 1 (np. z nakładającymi się kolumnami)
Twój Rząd Divi nr 2
Twój Rząd Divi nr 3
Twój Rząd Divi nr 1
Twój Rząd Divi nr 2
Twój Rząd Divi nr 3

Kompletny kod (Divi Builder)

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.css" />
<style>
    .custom-divi-slider-container {
        width: 100%;
        padding-top: 20px;
        padding-bottom: 70px;
        overflow: hidden;
        position: relative;
    }

    .custom-divi-slider-container .swiper-slide {
        width: 100%;
    }

    .custom-divi-slider-container .divi-slide-row {
        margin-top: 0 !important;
        margin-bottom: 0 !important;
        width: 100% !important;
        overflow: visible !important;
    }

    .swiper-pagination-bullet:focus-visible,
    .swiper-button-next:focus-visible,
    .swiper-button-prev:focus-visible {
        outline: 3px solid #005fcc !important;
        outline-offset: 3px;
    }

    .swiper-pagination-bullet-active {
        background: #111827 !important;
    }

    .swiper-button-prev { left: 6% !important; }
    .swiper-button-next { right: 6% !important; }

    @media (max-width: 980px) {
        .swiper-button-prev { left: 2% !important; }
        .swiper-button-next { right: 2% !important; }
        .swiper-button-next:after,
        .swiper-button-prev:after { font-size: 26px !important; }
    }

    @media (max-width: 767px) {
        .swiper-button-next,
        .swiper-button-prev { display: none !important; }
    }

    .swiper-button-next,
    .swiper-button-prev {
        color: #111827 !important;
        background: transparent !important;
        box-shadow: none !important;
        border-radius: 0;
        transition: transform 0.3s ease, opacity 0.3s ease;
    }

    .swiper-button-next:hover,
    .swiper-button-prev:hover {
        transform: scale(1.1);
        opacity: 0.7;
    }

    .swiper-button-next:after,
    .swiper-button-prev:after {
        font-size: 32px !important;
        font-weight: bold;
    }
</style>

<script src="https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.js"></script>
<script>
    document.addEventListener('DOMContentLoaded', function() {

        const rows = document.querySelectorAll('.divi-slide-row');

        if(rows.length === 0 || document.querySelector('html').classList.contains('et-fb-root-ancestor')) {
            return;
        }

        const parentSection = rows[0].closest('.et_pb_section');

        const swiperContainer = document.createElement('div');
        swiperContainer.className = 'swiper custom-divi-slider-container';

        const swiperWrapper = document.createElement('div');
        swiperWrapper.className = 'swiper-wrapper';

        const swiperPagination = document.createElement('div');
        swiperPagination.className = 'swiper-pagination';

        const swiperButtonNext = document.createElement('div');
        swiperButtonNext.className = 'swiper-button-next';
        const swiperButtonPrev = document.createElement('div');
        swiperButtonPrev.className = 'swiper-button-prev';

        rows.forEach(row => {
            const slide = document.createElement('div');
            slide.className = 'swiper-slide';
            slide.appendChild(row);
            swiperWrapper.appendChild(slide);
        });

        swiperContainer.appendChild(swiperWrapper);
        swiperContainer.appendChild(swiperPagination);
        swiperContainer.appendChild(swiperButtonNext);
        swiperContainer.appendChild(swiperButtonPrev);

        parentSection.insertBefore(swiperContainer, parentSection.firstChild);

        const swiper = new Swiper('.custom-divi-slider-container', {
            speed: 800,
            effect: 'fade',
            fadeEffect: { crossFade: true },
            slidesPerView: 1,
            spaceBetween: 30,
            loop: true,
            autoHeight: true,
            grabCursor: true,
            pagination: {
                el: '.swiper-pagination',
                clickable: true,
            },
            navigation: {
                nextEl: '.swiper-button-next',
                prevEl: '.swiper-button-prev',
            },
            keyboard: {
                enabled: true,
                onlyInViewport: true,
            },
            a11y: {
                enabled: true,
                prevSlideMessage: 'Poprzedni slajd',
                nextSlideMessage: 'Następny slajd',
                firstSlideMessage: 'To jest pierwszy slajd',
                lastSlideMessage: 'To jest ostatni slajd',
                paginationBulletMessage: 'Przejdź do slajdu {{index}}',
            }
        });
    });
</script>

Opcjonalnie: automatyczne przewijanie z przyciskiem play/pause (WCAG 2.2.2)

Domyślnie ten slider nie przewija się sam — użytkownik nawiguje strzałkami, kropkami, przeciągnięciem lub klawiaturą. Jeśli jednak chcesz dodać automatyczne przewijanie, poniżej masz gotowy wariant z ikonowym przyciskiem pauzy (w stylu „❚❚ / ►”, tak jak w karuzeli opinii z wcześniejszego wpisu w tej serii) zamiast przycisku z podpisem tekstowym. Przycisk jest tworzony dynamicznie przez ten sam skrypt, który buduje resztę slidera, więc nie trzeba nic dodatkowo wklejać ręcznie w HTML.

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.css" />
<style>
    .custom-divi-slider-container {
        width: 100%;
        padding-top: 20px;
        padding-bottom: 70px;
        overflow: hidden;
        position: relative;
    }

    .custom-divi-slider-container .swiper-slide {
        width: 100%;
    }

    .custom-divi-slider-container .divi-slide-row {
        margin-top: 0 !important;
        margin-bottom: 0 !important;
        width: 100% !important;
        overflow: visible !important;
    }

    .swiper-pagination-bullet:focus-visible,
    .swiper-button-next:focus-visible,
    .swiper-button-prev:focus-visible {
        outline: 3px solid #005fcc !important;
        outline-offset: 3px;
    }

    .swiper-pagination-bullet-active {
        background: #111827 !important;
    }

    .swiper-button-prev { left: 6% !important; }
    .swiper-button-next { right: 6% !important; }

    @media (max-width: 980px) {
        .swiper-button-prev { left: 2% !important; }
        .swiper-button-next { right: 2% !important; }
        .swiper-button-next:after,
        .swiper-button-prev:after { font-size: 26px !important; }
    }

    @media (max-width: 767px) {
        .swiper-button-next,
        .swiper-button-prev { display: none !important; }
    }

    .swiper-button-next,
    .swiper-button-prev {
        color: #111827 !important;
        background: transparent !important;
        box-shadow: none !important;
        border-radius: 0;
        transition: transform 0.3s ease, opacity 0.3s ease;
    }

    .swiper-button-next:hover,
    .swiper-button-prev:hover {
        transform: scale(1.1);
        opacity: 0.7;
    }

    .swiper-button-next:after,
    .swiper-button-prev:after {
        font-size: 32px !important;
        font-weight: bold;
    }

    /* Ikonowy przycisk play/pause - w stylu karuzeli opinii z wcześniejszego wpisu */
    .swiper-pause-btn {
        position: absolute;
        bottom: 8px;
        right: 16px;
        z-index: 20;
        background: none;
        border: none;
        cursor: pointer;
        font-size: 18px;
        line-height: 1;
        color: #111827;
        transition: color 0.3s;
        padding: 10px 15px;
        min-width: 44px;
        min-height: 44px;
    }
    .swiper-pause-btn:not(.paused)::after { content: "❚❚"; }
    .swiper-pause-btn.paused::after { content: "►"; }
    .swiper-pause-btn:focus-visible {
        outline: 3px solid #005fcc;
        outline-offset: 2px;
        border-radius: 4px;
    }
    @media (max-width: 767px) {
        .swiper-pause-btn {
            bottom: 4px;
            right: 8px;
        }
    }
</style>

<script src="https://cdn.jsdelivr.net/npm/swiper@11/swiper-bundle.min.js"></script>
<script>
    document.addEventListener('DOMContentLoaded', function() {

        const rows = document.querySelectorAll('.divi-slide-row');

        if(rows.length === 0 || document.querySelector('html').classList.contains('et-fb-root-ancestor')) {
            return;
        }

        const parentSection = rows[0].closest('.et_pb_section');
        const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;

        const swiperContainer = document.createElement('div');
        swiperContainer.className = 'swiper custom-divi-slider-container';

        const swiperWrapper = document.createElement('div');
        swiperWrapper.className = 'swiper-wrapper';

        const swiperPagination = document.createElement('div');
        swiperPagination.className = 'swiper-pagination';

        const swiperButtonNext = document.createElement('div');
        swiperButtonNext.className = 'swiper-button-next';
        const swiperButtonPrev = document.createElement('div');
        swiperButtonPrev.className = 'swiper-button-prev';

        // Ikonowy przycisk play/pause, tworzony dynamicznie
        const swiperPauseBtn = document.createElement('button');
        swiperPauseBtn.className = 'swiper-pause-btn';
        swiperPauseBtn.setAttribute('aria-pressed', 'false');
        swiperPauseBtn.setAttribute('aria-label', 'Zatrzymaj automatyczne przewijanie');

        rows.forEach(row => {
            const slide = document.createElement('div');
            slide.className = 'swiper-slide';
            slide.appendChild(row);
            swiperWrapper.appendChild(slide);
        });

        swiperContainer.appendChild(swiperWrapper);
        swiperContainer.appendChild(swiperPagination);
        swiperContainer.appendChild(swiperButtonNext);
        swiperContainer.appendChild(swiperButtonPrev);
        swiperContainer.appendChild(swiperPauseBtn);

        parentSection.insertBefore(swiperContainer, parentSection.firstChild);

        const swiper = new Swiper('.custom-divi-slider-container', {
            speed: 800,
            effect: 'fade',
            fadeEffect: { crossFade: true },
            slidesPerView: 1,
            spaceBetween: 30,
            loop: true,
            autoHeight: true,
            grabCursor: true,
            pagination: {
                el: '.swiper-pagination',
                clickable: true,
            },
            navigation: {
                nextEl: '.swiper-button-next',
                prevEl: '.swiper-button-prev',
            },
            keyboard: {
                enabled: true,
                onlyInViewport: true,
            },
            a11y: {
                enabled: true,
                prevSlideMessage: 'Poprzedni slajd',
                nextSlideMessage: 'Następny slajd',
                firstSlideMessage: 'To jest pierwszy slajd',
                lastSlideMessage: 'To jest ostatni slajd',
                paginationBulletMessage: 'Przejdź do slajdu {{index}}',
            },
            autoplay: prefersReducedMotion ? false : {
                delay: 5000,
                disableOnInteraction: false,
            }
        });

        // Obsługa przycisku play/pause
        let playing = !prefersReducedMotion;
        if (prefersReducedMotion) {
            swiperPauseBtn.classList.add('paused');
            swiperPauseBtn.setAttribute('aria-pressed', 'true');
            swiperPauseBtn.setAttribute('aria-label', 'Wznów automatyczne przewijanie');
        }

        swiperPauseBtn.addEventListener('click', function () {
            playing = !playing;
            if (playing) {
                swiper.autoplay.start();
                swiperPauseBtn.classList.remove('paused');
                swiperPauseBtn.setAttribute('aria-pressed', 'false');
                swiperPauseBtn.setAttribute('aria-label', 'Zatrzymaj automatyczne przewijanie');
            } else {
                swiper.autoplay.stop();
                swiperPauseBtn.classList.add('paused');
                swiperPauseBtn.setAttribute('aria-pressed', 'true');
                swiperPauseBtn.setAttribute('aria-label', 'Wznów automatyczne przewijanie');
            }
        });
    });
</script>

Uwaga: ten wariant zastępuje cały blok Kod z poprzedniej sekcji — nie wklejaj obu jednocześnie w tym samym rzędzie, wybierz jeden z dwóch (bez autoplay albo z autoplay i pauzą), w zależności od tego, czy chcesz automatyczne przewijanie na danej stronie.

Checklista wdrożeniowa

  • Każdy rząd, który ma być slajdem, ma klasę CSS divi-slide-row.
  • Moduł Kod jest umieszczony pod ostatnim rzędem z tą klasą, w tej samej sekcji.
  • Skrypt sprawdza obecność Visual Buildera (et-fb-root-ancestor) i przerywa działanie w edytorze wizualnym.
  • Efekt fade z crossFade: true bez żadnych ręcznych modyfikacji opacity w CSS.
  • Moduł a11y włączony z polskimi komunikatami.
  • keyboard.onlyInViewport: true.
  • Strzałki nawigacji ukryte na telefonach (poniżej 767px).
  • autoHeight: true — slider dopasowuje wysokość do zawartości bieżącego rzędu.
  • Jeśli używasz wariantu z autoplay — ikonowy przycisk pauzy jest widoczny, ma min. 44×44px klikalnego obszaru i aktualizujący się aria-label/aria-pressed.
  • Wariant z autoplay respektuje prefers-reduced-motion — bez tej preferencji slider startuje wstrzymany, z przyciskiem pokazującym stan „wznów”.

FAQ

Czy mogę użyć tego skryptu z rzędami zawierającymi nakładające się kolumny (overlapping columns)?

Tak — to jeden z głównych powodów, dla których ten skrypt istnieje. overflow: visible !important na .divi-slide-row w kontenerze slidera celowo zapobiega ucinaniu elementów wystających poza standardowe granice rzędu.

Dlaczego nie mogę dodać własnego stylu opacity do slajdów?

Bo skonfliktuje się z wewnętrznym zarządzaniem przenikaniem przez crossFade: true, co objawia się widocznym „przeskokiem” przy pierwszej zmianie slajdu. Cały efekt fade zostaw w rękach konfiguracji Swiper.js.

Co się stanie, jeśli otworzę stronę w Divi Visual Builderze?

Skrypt wykrywa środowisko edytora wizualnego i nie uruchamia się wcale — dzięki temu edycja rzędów w Builderze pozostaje w pełni funkcjonalna, bez ryzyka, że przenoszenie węzłów DOM ją zaburzy.


Masz treść, która nie mieści się w standardowej strukturze slidera i potrzebujesz podobnego rozwiązania u siebie? Napisz do mnie i umów konsultację — dopasuję mechanizm do Twoich rzędów i układu.