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ł
a11ySwiper.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-visiblena 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-labeli minimalnym obszarem klikalnym 44×44px.
Instrukcja wdrożenia w Divi
- Zbuduj swoje rzędy normalnie w Divi Builderze — najlepiej, żeby miały zbliżoną szerokość.
- 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. - Pod ostatnim rzędem dodaj moduł Kod (Code).
- 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.
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
fadezcrossFade: truebez żadnych ręcznych modyfikacjiopacityw CSS. - Moduł
a11ywłą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
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.
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.
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.
