Слайдер для сайта на Owl Carousel 2

Owl Carousel 2 — это проверенный временем jQuery-плагин для создания адаптивных слайдеров, который до сих пор активно используется в проектах, где не требуется тяжёлый JavaScript-фреймворк. Несмотря на то что библиотека не обновлялась несколько лет, её стабильность и простота делают её популярным выбором для лендингов, интернет-магазинов и блогов .
Ниже — пошаговое руководство по установке и настройке слайдера, а также важные нюансы для WordPress, где неправильное подключение скриптов встречается чаще всего.
📦 Шаг 1: Подключение файлов
Owl Carousel 2 требует jQuery (минимум версии 1.8.3), поэтому порядок загрузки скриптов критичен: сначала jQuery, затем сам плагин .
Для статичного HTML подключите файлы в <head> и перед закрывающим </body>:
1 2 3 4 5 6 7 | <!-- В <head>: стили --> <link rel="stylesheet" href="owlcarousel/owl.carousel.min.css"> <link rel="stylesheet" href="owlcarousel/owl.theme.default.min.css"> <!-- Перед </body>: скрипты --> <script src="jquery.min.js"></script> <script src="owlcarousel/owl.carousel.min.js"></script> |
Файл owl.theme.default.min.css необязателен, но без него вам придётся самостоятельно стилизовать точки навигации и стрелки .
Для WordPress не вставляйте теги <link> и <script> напрямую в шаблон. Это частая причина конфликтов и повторной загрузки jQuery. Используйте функцию wp_enqueue_scripts в functions.php вашей дочерней темы :
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 | function my_enqueue_owl_carousel() { // Стили wp_enqueue_style( 'owl-carousel', 'https://cdnjs.cloudflare.com/ajax/libs/OwlCarousel2/2.3.4/assets/owl.carousel.min.css', array(), '2.3.4' ); wp_enqueue_style( 'owl-carousel-theme', 'https://cdnjs.cloudflare.com/ajax/libs/OwlCarousel2/2.3.4/assets/owl.theme.default.min.css', array('owl-carousel'), '2.3.4' ); // Скрипты (зависимость от jquery) wp_enqueue_script( 'owl-carousel', 'https://cdnjs.cloudflare.com/ajax/libs/OwlCarousel2/2.3.4/owl.carousel.min.js', array('jquery'), '2.3.4', true // загружать в футере ); } add_action('wp_enqueue_scripts', 'my_enqueue_owl_carousel'); |
Параметр array('jquery') гарантирует, что Owl загрузится после jQuery, а true в конце переместит скрипт в футер, чтобы не блокировать отрисовку страницы .
🏗️ Шаг 2: HTML-разметка
Оберните элементы слайдера в контейнер с обязательным классом owl-carousel. Класс owl-theme добавит стандартное оформление навигации .
1 2 3 4 5 | <div class="owl-carousel owl-theme"> <div class="item"><img src="slide1.jpg" alt="Слайд 1"></div> <div class="item"><img src="slide2.jpg" alt="Слайд 2"></div> <div class="item"><img src="slide3.jpg" alt="Слайд 3"></div> </div> |
Внутри контейнера могут быть любые элементы: div, img, a, span — плагин работает с любыми блочными или строчными тегами .
⚙️ Шаг 3: Инициализация и базовая настройка
Вызовите плагин после загрузки DOM. Важно для WordPress: встроенный jQuery работает в режиме noConflict, поэтому использовать $ напрямую нельзя. Оборачивайте код в функцию, принимающую jQuery как параметр, либо пишите jQuery вместо $ .
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 | jQuery(document).ready(function($) { $('.owl-carousel').owlCarousel({ loop: true, margin: 10, nav: true, dots: true, autoplay: true, autoplayTimeout: 5000, autoplayHoverPause: true, responsive: { 0: { items: 1 }, 600: { items: 2 }, 1000: { items: 3 } } }); }); |
Ключевые опции для старта :
items: количество видимых слайдов (по умолчанию 3).margin: отступ между слайдами в пикселях.loop: бесконечная прокрутка (дублирует первый и последний слайды).nav/dots: показывать стрелки / точки навигации.autoplayиautoplayTimeout: автопрокрутка и интервал (мс).responsive: объект с брейкпоинтами. Внутри каждого брейкпоинта можно переопределитьitems,navи другие параметры. Брейкпоинты применяются от меньшего к большему, и настройки внутри них перекрывают верхнеуровневые .
⚠️ Частые ошибки и как их избежать
Слайдер не работает, в консоли ошибка $ is not a function
Это классическая проблема WordPress. Причина — noConflict режим jQuery. Решение: обернуть инициализацию в jQuery(document).ready(function($) { ... }) или заменить все $ на jQuery .
Слайды отображаются вертикально или без стилей
Не подключён файл owl.carousel.min.css или он загружается с ошибкой. Проверьте путь к файлу в консоли браузера (вкладка Network). Если сайт на HTTPS, CDN-ссылка тоже должна быть с https://, иначе браузер заблокирует загрузку .
Слайдер «прыгает» или неправильно считает ширину
Часто возникает, если контейнер слайдера изначально скрыт (например, внутри таба). Owl Carousel не может корректно рассчитать ширину невидимого элемента. Решение: инициализировать слайдер после того, как контейнер стал видимым, либо вызвать метод refresh вручную.
Owl Carousel 2 vs Slick
Если вы выбираете библиотеку с нуля, учтите: Slick активнее поддерживается и имеет больше готовых тем. Owl 2 выигрывает в простоте базовой настройки и меньшем размере, но не стоит ждать обновлений под новые версии браузеров .
💎 Итог
Owl Carousel 2 остаётся рабочим инструментом для быстрого запуска адаптивного слайдера. Главное правило — корректно подключить зависимости (jQuery до Owl) и в WordPress использовать wp_enqueue_scripts, а не прямые теги в шаблоне. Если проект новый и не привязан к legacy-коду, стоит рассмотреть современные альтернативы (Swiper, Splide), но для поддержки существующих сайтов или простых задач Owl 2 по-прежнему справляется со своей работой.
