Адаптивная карусель для bootstrap 3. Создаем собственный слайдер на бутстрап за несколько простых шагов. Карусель с элементами управления
Twitter Bootstrap 3 является одним из лучших фреймворков CSS, чтобы разрабатывать и поддерживать системы управления контентом. С Bootstrap вы можете легко создавать блоги или портфолио, используя систему сеток Twitter Bootstrap (grid layout). В основе многих систем CMS, мы, как правило, имеем такой базовый компонент как "Slider" (Карусель), в основном - это автоматически-последовательное отображение изображений, но также он может отображать последние завершенные проекты, отзывы ваших клиентов, описание специальных предложений, ссылки на новости или последние статьи из блога. В этой статье мы рассмотрим, как создать слайдер с помощью компонента Carousel в Twitter Bootstrap 3 .
Введение в компонент Carousel Twitter Bootstrap 3Разметка для компонента карусели выглядит так:
...
...
Из приведенного выше кода, мы видим, что слайдер Bootstrap 3 делится на несколько частей:
- Указатели
- Содержание слайдера
- Элементы управления
Чтобы переобразовать элемент div в слайдер, мы добавляем имена классов: carousel и slide . Класс carousel создает эффект «карусели», то есть изменяет слайды по кругу. Класс slide добавляет скользящую анимацию из правой или левой стороны. Указатели - это маленькие круги в нижней части слайдера, они определяют текущее положение слайда и количество слайдов. Указатели создаются с помощью упорядоченного списка.
Упорядоченный список имеет класс carousel-indicators , который преобразует дочерние элементы в виде небольших кругов. Каждый элемент li должен иметь атрибут data-target с идентификатором родительского контейнера. Он также должен иметь атрибут data-slide-to с уникальным цифровым значением, чтобы ссылаться на конкретный слайд, значения должны начинаться с "0".
...
...
Каждый элемент с классом item имеет два подраздела: image и carousel-caption . Изображение используется в качестве фона для слайда. Элемент с классом carousel-caption расположен над изображением, и используется в качестве заголовка слайда. Внутри carousel-caption , мы можем добавить или теги, или даже оба.
Управление осуществляется стрелками влево и вправо, они используются для изменения слайдов вручную.
Там должно быть два элемента: по одному для каждого направления. Первый элемент будет иметь span элемент с классами glyphicon glyphicon-chevron-left , который является значком со стрелкой влево, а второй элемент будет иметь классы glyphicon glyphicon-chevron-right , это стрелка вправо. В Bootstrap, чтобы отобразить иконки, мы можем использовать шрифты вместо изображений.
Вот и всё! Вы успешно создали слайдер для вашего сайта. Кроме того, вы не написали ни строчки кода JavaScript, но bootstrap.js сделал все за вас.
Настройки CarouselДля дополнительной настройки слайдера можно добавить несколько атрибутов data-* для родительского контейнера карусели.
- "data-interval " используется для указания интервала времени между переключением слайдов. Он принимает числовое значение, и число должно быть в миллисекундах.
- "data-pause " используется для определения момента, когда событие "пауза" будет вызвано. Например, когда оно равно "hover ", переключение слайдов останавливается, когда мышь находится над слайдером.
- "data-wrap " является булевым атрибутом и позволяет установить, следует ли возобновить переключение слайдов, если конец списка слайдов будет достигнут.
Если вы хотели бы использовать jQuery и data-* атрибуты, Bootstrap позволяет инициализацию с помощью JavaScript. Для этого вы можете написать следующий код:
$(".carousel" ) .carousel () ;
Настройки карусели могут быть установлены с помощью параметров. Например:
$(".carousel"
)
.carousel
({
interval:
2000
,
pause:
"hover"
,
wrap:
true
}
)
;
Вы также можете вызвать вручную события слайдера, используя следующий код:
- .carousel("pause") // пауза
- .carousel("cycle") // включить слайды
- .carousel(3) // показать четвертый слайд
- .carousel("prev") // показать предыдущий слайд
- .carousel("next") // показать следующий слайд
Приведенные выше методы могут быть вызваны из любого кода JavaScript, чтобы управлять обычной работой слайдера. Я считаю, что prev и next методы очень полезны если я хочу показать мои собственные кнопки вместо стандартных стрелок. Особенно, когда они находятся за пределами макета карусели.
ЗаключениеЭта статья должна быть полезной для тех, кто хочет узнать как создать слайдер без написания тысячи строк кода в JavaScript. Без сомнения, это позволит увеличить скорость разработки. Самое главное, что это решение кроссбраузерно, так что вам не придется рвать на себе волосы, чтобы заставить его работать в старых браузерах.
Если у Вас возникли вопросы, то для скорейшего получения ответа рекомендуем воспользоваться нашим
Реализуем слайдер на Фреймворке bootstrap , который так же известен как Twitter Bootstrap . Для этого перейдем на сайт Bootstrap , скачаем его файлы к себе на компьютер, и данные файлы перенести в свою среду разработки.
Я заранее подготовил всю структуру, подключил их в их в index файле, а вы можете скачать весь архив по ссылка ниже.
Распакуйте его и перенесите все файлы в свою среду разработки.
Рассмотрим структуру архиваПробежимся по его структуре архива, рассмотрим что в нем находится.
Открываем index файл, в самом верху подключена библиотека Jquery , за ней подключен фреймворк bootstrap с расширением js который находится в папке JS, за ним подключаем bootstrap с расширением CSS, и ниже подключаем файл, где будем писать свои стили, все это находится в папке CSS. В папке fonts , расположены иконки, которые использует bootstrap, в Img расположены картинки на слайдер и картинка на задний фон.
Это и есть весь шаблон, и вся его структура, далее приступим к описанию каркаса.
Адаптивный слайдер
Описываем каркас слайдераСоздаем блок div с идентификатором слайдера id="dws-slider" , добавляем класс "carousel slide" .
Затем прописываем каждый элемент слайда в отдельном блоке и таких делаем три штуки.
(.item>img+.carousel-caption>h3.text-uppercase+p)*3
И для того что бы отобразился первый слайд нужно добавить для первого элемента класс .active . Затем заполняем блоки текстовым содержанием.
Адаптивный слайдер
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin aliquet elit lorem, ac congue mi eleifend sit amet. Sed dignissim viverra neque a tristique.
Анимированная прокруткаAenean cursus imperdiet erat sit amet facilisis. Phasellus congue, sem in consectetur accumsan, tellus risus sollicitudin mauris, quis ornare libero magna eget ex.
Простая установкаPraesent dictum, orci eget eleifend auctor, urna ex dapibus odio, vitae pretium neque massa vel neque. Donec et interdum diam. Morbi dignissim vestibulum mi ac viverra.
Теперь добавим элементы управления по бокам слайдера.
Previous Next
Остановим временно автолистинг.
$(".carousel").carousel({ interval: false })
Добавим показатели прокрутки.
Описываем стили и анимацию
Перейдем в файл стилей и опишем блоки с текстом.
Carousel-inner h3 { background-color: rgba(20, 49, 68, 0.6); padding: 20px; } .carousel-inner p { font-size: 18px; background-color: rgba(30, 29, 29, 0.6); padding: 20px; }
Присвоим им ключевые кадры и сделаем анимацию.
Carousel-inner h3 { background-color: rgba(20, 49, 68, 0.6); padding: 20px; animation: anim-H3 1.3s ease-out; } .carousel-inner p { font-size: 18px; background-color: rgba(30, 29, 29, 0.6); padding: 20px; animation: anim-P 1.6s ease-out; } @keyframes anim-H3 { from { opacity: 0; transform: translateX(-2000px); } to { opacity: 1; transform: translateX(0); } } @keyframes anim-P { from { opacity: 0; transform: translateX(2000px); } to { opacity: 1; transform: translateX(0); } }
Адаптируем блоки с текстом
Для того чтобы корректно работали стили медиа запросов пропишем мета тег viewport.
Переходим в файл медиа и опишем в нем стили для блоков с текстом под разные расширения.
Carousel-inner h3 { font-size: 20px; padding: 15px; } .carousel-inner p { font-size: 16px; padding: 10px; } @media all and (max-width: 768px) { .carousel-caption { bottom: 10%; } .carousel-inner h3 { font-size: 18px; } .carousel-inner p { font-size: 14px; } } @media all and (max-width: 600px) { .carousel-inner h3 { display: none; } .carousel-inner p { display: none; } }
Затем можно задать автоскрол в 7 сек, и слайдер у нас готов.
$(".carousel").carousel({ interval: 7000 })
Понравился пример реализации слайдера на Bootstrap 3, поделись им с друзьями в социальных сетях.
Урок подготовил Горелов Денис.
В этой статье рассмотрим как на страницу, к которой подключён Bootstrap 3 или 4 версии, добавить карусель или слайдер. Содержимое слайдов карусели может быть разнообразным: текстовым, в виде изображения или другого контента.
Что такое карусель?Carousel (карусель) – это элемент интерфейса для демонстрации на сайте серии изображений (слайдов). Каждое изображение (слайд) демонстрируется обычно несколько секунд, пока не сменится следующим. Смена изображения (слайда) может осуществляться как автоматически через равные промежутки времени, так и вручную.
Слайд в Bootstrap карусели может быть представлен не только изображением , но и текстовым контентом . Кроме этого при создании слайда можно использовать разметку.
В Bootstrap компонент Carousel построен с помощью технологии CSS 3D Transforms и кода JavaScript.
Карусель в Bootstrap реализована с использованием Page Visibilty API . Это означает, что если браузер поддерживает этот API , то карусель не будет осуществлять автоматическую смену слайдов до тех пор, пока она не будет видна пользователю. Например, до тех пор, пока вкладка, содержащая карусель, будет находиться в не активном или свёрнутом состоянии.
Фреймворк Boostrap 3 и 4 не позволяет создавать вложенные карусели.
Карусель без элементов управленияКомпонент Carousel автоматически не нормализует размеры изображений (слайдов)
. Таким образом, могут потребоваться дополнительные утилиты или стили, чтобы привести содержимое к необходимому размеру.
Один из примеров, как это выполнить с помощью CSS, можно посмотреть в этой статье .
Важно! Класс active необходимо добавить к одному из слайдов. Если это не выполнить, то карусель не будет отображаться.
HTML-разметка карусели в Bootstrap 3:
HTML разметка карусели в Bootstrap 4 отличается только классом item . Вместо него необходимо использовать carousel-item . Кроме этого в Boostrap 4 к изображениям, для придания им адаптивности, необходимо добавить класс img-fluid .
HTML-разметка карусели в Bootstrap 4:
Атрибут data-ride="carousel" запускает автоматическую смену слайдов карусели после загрузки страницы. Если инициализация карусели выполняется с помощью JavaScript, то этот атрибут не нужно использовать.
Карусель с элементами управленияВажно! Карусель с элементами управления и (или) с индикаторами слайдов должна иметь id . А элементы управления и индикаторы слайдов должны иметь атрибут data-target (или href для ссылок), значение которого должно указывать на карусель (т.е. состоять из # и id ).
HTML разметка карусели с элементами управления для перехода к предыдущему и следующему слайду:
Предыдущий Следующий
Предыдущий Следующий
Поведение кнопок «Предыдущий» и «Следующий» определяется в карусели с помощью атрибута data-slide .
Значение prev данного атрибута связывает с кнопкой определённые действия, с помощью которых она будет осуществлять смену текущего слайда на предыдущий . Значение next связывает с кнопкой соответственно другие действия, которые будут выполнять смену текущего слайда на следующий .
Карусель с индикаторами слайдовК карусели с элементами управления, также можно ещё добавить индикаторы слайдов.
Предыдущий Следующий
Предыдущий Следующий
Атрибут data-slide-to добавляет к карусели возможность дополнительной навигации по слайдам с помощью индикаторов. Атрибут data-slide-to в качестве значения содержит порядковый номер (индекс) слайда. Отсчёт слайдов в карусели ведётся с нуля. Если необходимо чтобы при клике на индикатор пользователь перешёл, на третий слайд, то к индикатору необходимо добавить атрибут data-slide-to со значением 2 .
Добавление надписей к слайдам каруселиК слайдам можно добавить надписи. Осуществляется это посредством добавления к каждому слайду, некоторого элемента, например, div, с классом carousel-caption . При необходимости эти надписи можно с помощью классов display отображать на одних экранах и скрывать на других.
Классы Boostrap 4 предназначенные для управления отображением элементов приведены в этой статье .
... ... ... Предыдущий Следующий
... ... ... Предыдущий Следующий
Карусель с анимацией появления (Bootstrap 4)Добавьте к карусели класс carousel-fade , чтобы изменить анимацию перехода на анимацию появления.
Предыдущий Следующий
Инициализация карусели с помощью JavaScriptКарусель можно активировать с помощью кода JavaScript:
$(".carousel").carousel();
Вместо ".carousel" укажите необходимый селектор для выбора одной или множества каруселей, которые нужно активировать.
Настройка каруселиНастройка карусели осуществляется с помощью параметров . Параметры можно устанавливать как с помощью data-атрибутов, так и посредством JavaScript.
При использовании data-атрибутов , добавьте к имени параметра приставку data- . Например, для установки параметра interval необходимо использовать атрибут с именем data-interval .
interval | Значение по умолчанию (миллисекунд): 5000, т.е. 5 секунд. Параметр interval устанавливает количество времени в миллисекундах (паузу) между автоматической сменой слайдов карусели. Если данному параметру указать значение false , то карусель не будет выполнять автоматическую смену слайдов. |
keyboard | Значение по умолчанию: true. Данный параметр определяет должна ли карусель реагировать на события клавиатуры. |
pause |
Значение по умолчанию: "hover".
Если параметр pause
имеет значение "hover"
, то смена слайдов, при нахождении курсора над ней, не будет выполняться. А при покидании курсора смена слайдов будет опять возобновляться. Если параметру pause установить значение false , то нахождение курсора над каруселью не будет останавливать автоматическую смену слайдов. На устройствах с сенсорным экраном, при значении "hover" , пауза будет устанавливаться на касание. Но после касания, карусель начнёт сменять слайды только после времени, равное 2 интервалам (по умолчанию, равное 10 секундам). |
ride | Значение по умолчанию: false. При значении false , запуск автоматической смены слайдов произойдёт только после того, как пользователь вручную (с помощью элементов управления или индикаторов) перейдёт к другому слайду. Если в качестве этого параметра установить значение "carousel" , то смена слайдов запустится автоматически сразу после загрузки страницы. |
wrap | Значение по умолчанию: true. Данный параметр определяет должна ли смена слайдов зацикливаться. Т.е. после последнего слайда осуществляться переход к первому при движении next и после первого к последнему при движении prev . Если это не нужно, то значение параметра wrap необходимо установить равное false . |
Методы плагина Carousel приведены в таблице.
Пример инициализации карусели с параметрами:
... ... $(function () { $("#carousel").carousel({ interval: 10000, keyboard: false, pause: "hover", ride: "carousel", wrap: false }); });
Пример использование методов для управления каруселью:
Запустить Остановить Предыдущий Следующий На 1 слайд На 2 слайд На 3 слайд ... $(function () { // метод cycle $(".btn").click(function () { var action = $(this).attr("data-action"); if (action.indexOf("to") >= 0) { var action = parseInt(action.substring(3))-1; } $("#carousel").carousel(action); }); });
События плагина CarouselJS Bootstrap генерирует для карусели два события.
Оба эти события имеют следующие дополнительные свойства:
- direction - направление слайдинга ("left" или "right" );
- relatedTarget - DOM-элемент, который перемещается на место текущего;
- from - индекс текущего элемента;
- to - индекс следующего элемента.
Свойства from и to имеются только в Bootstrap 4.
Пример работы с событиями:
... ... $(function () { var t = function () { var now = new Date(); var m = now.getMinutes(); var s = now.getSeconds(); if (m < 10) m = "0" + m; if (s < 10) s = "0" + s; return m + ":" + s; }; $("#carousel").on("slide.bs.carousel", function (e) { $(".log").prepend("
Пример работы с событиями карусели в Bootstrap 3:
Открыть пример Изменение длительности перехода (Bootstrap 4)Длительность перехода элементов .carousel-item может быть изменена с помощью Sass переменной $carousel-transition перед компиляцией или пользовательскими стилями, если используете уже скомпилированный CSS. Если применяете несколько переходов, то выполните сначала transition transform (например: transform 2.5s ease, opacity .75s ease-out ).
Примеры1. Карусель с автоматической нумерацией слайдов:
.carousel-number { position: absolute; top: 0; right: 0; width: 40px; height: 40px; background-color: rgba(255, 255, 255, .8); line-height: 40px; font-size: 20px; } ... $(".carousel").find(".carousel-item").each(function (index, item) { var carouselItem = $(item).find(".carousel-number"); if (carouselItem.length > 0) { carouselItem.text(index + 1); return; } var element = $(""); element .addClass("carousel-number") .text(index + 1); $(item).append(element); });
Доброго времени суток всем желающим выучить что-то новенькое из элементов фреймворка Bootstrap. Сегодняшней темой станет слайдер Бутстрап типа «Карусель». Это популярный элемент, который присутствует практически на каждом веб-сайте.
Поэтому я расскажу вам, как создать слайдер «Карусель», какие для этого понадобятся встроенные инструменты, как можно производить настройку параметров, а в конце статьи покажу реализацию конкретного примера. А теперь вперед за дело!
Все об инструментах Bootstrap Carousel PluginГалерея фотографий типа «Карусель» используется для презентации новых предложений, продукции, перечня действующих акций, удобного просмотра портфолио и т.д. Поэтому на сегодняшний день важно уметь работать с данным плагином под официальным названием Bootstrap Carousel Plugin.
Стоит сразу заметить, что описываемый элемент должным образом не поддерживается в браузере Internet Explorer 9 и более ранних версиях. Однако прекрасно работает в (для WordPress, Joomla! и других движков выполнить подключение фреймворка достаточно просто).
Для того чтобы с легкостью оперировать всеми параметрами и быстро настраивать слайдер, вам необходимо изучить основные встроенные классы Бутстрапа 3.
Класс | Предназначение |
carousel | Создает сам слайдер «Карусель». |
slide | Добавляет при помощи css эффект анимации и переходов во время переключения между слайдами. Класс не обязательный. |
carousel-indicators | Добавляет так скажем панель управления в виде небольших точек снизу каждого изображения, по которым можно быстро переходить на любую картинку. Класс не обязательный. |
carousel-inner | Добавляет сами слайды в галерею. |
carousel-caption | Отвечает за подписи графических файлов. Можно включать по желанию. |
item | Определяет набор контента для каждого слайда. |
Right / left carousel-control | Добавляет правую и левую кнопки соответственно названию для переключения между кадрами. |
Помимо этого, стоит знать и другие особенности верстки подобных галерей.
Для начала, создание самого блока «Карусели» требует объявления id="myCarousel" для корректного функционирования последней.
В этом же div-е нужно прописать атрибут data-ride="carousel" , который указывает, что загрузка анимации должна происходить сразу же вместе с загрузкой страницы.
Теперь перейдем к индикаторам. В каждом теге li стоит прописать парочку атрибутов: data-target , который указывает на идентификатор конкретной «Карусели», и data-slide-to , определяющий к какому номеру кадра стоит прейти.
Что касается кнопок, переключающих изображения вперед или назад, то для их реализации стоит прописать атрибут data-slide с ключевым словом либо «prev», либо «next».
Вот теперь вы знаете про базовые элементы фреймворка, благодаря которым можно определенным образом редактировать отображение слайдера. Естественно вы можете отключить автоматическое перелистывание кадров, подписи к изображениям или боковые кнопки.
Альтернативные механизмы управленияПомимо использования встроенных классов в Bootstrap можно обратиться за помощью к . Так, существует множество методов и опций в JS, которые реализуют все те же действия, только через инструмент $.carousel (). Среди них можно перечислить такие, как:
Контрольный по знаниямНу а теперь пришло время проверить, как вы усвоили материал, и закрепить полученные знания. Для этого я опишу каждое действие, которое вам нужно будет совершить на пути к созданию «Карусели».
Для начала вам необходимо подключить требуемые скрипты и стили. Я предпочитаю , но вы можете загрузить фреймворк на официальном сайте (http://getbootstrap.com/ ) и поместить скачанные файлы в корень каталога с проектом.
Если вы со мной солидарны, то в шапке документа прописываем:
1 2 3 |
Если же вы сторонник второго способа, то вместо первой части ссылки вам нужно вставить путь к файлу.
Теперь осталось внедрить в слайдер. Для этого используйте свои полученные знания и прописывайте нужные куски кода по порядку:
Исключаться из этого перечня может только второй и последний div-ы.
Теперь вы уж точно готовы к написанию программного кода.
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 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 |
Пример галереи "Карусель"
.carousel-inner > .item > img,
.carousel-inner > .item > a >
/*Создаю основной блок*/ /*Заполняю слайды*/ Романтичный Праздничный Домашний Свадебный Previous Next |
Пример галереи "Карусель"
.carousel-inner > .item > img,
.carousel-inner > .item > a > img {
width: 70%;
margin: auto;
}
/*Создаю основной блок*/
/*Указываю 4 индикатора в соответствии с количеством изображений*/
/*Заполняю слайды*/
Романтичный
Букет нежных роз для признания в любви
ПраздничныйЯркий подарок для любого торжества
ДомашнийКорзина свежих цветов привнесет уют в любой дом
СвадебныйНежная цветовая гамма подчеркнет значимость события
/*Создаю боковые кнопки управления*/ Previous NextA slideshow component for cycling through elements-images or slides of text-like a carousel.
How it worksThe carousel is a slideshow for cycling through a series of content, built with CSS 3D transforms and a bit of JavaScript. It works with a series of images, text, or custom markup. It also includes support for previous/next controls and indicators.
Please be aware that nested carousels are not supported, and carousels are generally not compliant with accessibility standards.
ExampleCarousels don’t automatically normalize slide dimensions. As such, you may need to use additional utilities or custom styles to appropriately size content. While carousels support previous/next controls and indicators, they’re not explicitly required. Add and customize as you see fit.
The .active class needs to be added to one of the slides otherwise the carousel will not be visible. Also be sure to set a unique id on the .carousel for optional controls, especially if you’re using multiple carousels on a single page. Control and indicator elements must have a data-target attribute (or href for links) that matches the id of the .carousel element.
Slides onlyHere’s a carousel with slides only. Note the presence of the .d-block and .w-100 on carousel images to prevent browser default image alignment.
Placeholder First slide
Placeholder Second slide
Placeholder Third slide
With controlsAdding in the previous and next controls:
Previous Next With indicatorsYou can also add the indicators to the carousel, alongside the controls, too.
Previous Next With captionsAdd captions to your slides easily with the .carousel-caption element within any .carousel-item . They can be easily hidden on smaller viewports, as shown below, with optional display utilities . We hide them initially with .d-none and bring them back on medium-sized devices with .d-md-block .
Placeholder First slide
First slide labelNulla vitae elit libero, a pharetra augue mollis interdum.
Placeholder Second slide
Second slide labelLorem ipsum dolor sit amet, consectetur adipiscing elit.
Placeholder Third slide
Third slide labelPraesent commodo cursus magna, vel scelerisque nisl consectetur.
First slide labelNulla vitae elit libero, a pharetra augue mollis interdum.
Second slide labelLorem ipsum dolor sit amet, consectetur adipiscing elit.
Third slide labelPraesent commodo cursus magna, vel scelerisque nisl consectetur.
Previous Next CrossfadeAdd .carousel-fade to your carousel to animate slides with a fade transition instead of a slide.
Previous Next Individual .carousel-item intervalAdd data-interval="" to a .carousel-item to change the amount of time to delay between automatically cycling to the next item.
Previous Next Usage Via data attributesUse data attributes to easily control the position of the carousel. data-slide accepts the keywords prev or next , which alters the slide position relative to its current position. Alternatively, use data-slide-to to pass a raw slide index to the carousel data-slide-to="2" , which shifts the slide position to a particular index beginning with 0 .
The data-ride="carousel" attribute is used to mark a carousel as animating starting at page load. If you don’t use data-ride="carousel" to initialize your carousel, you have to initialize it yourself. It cannot be used in combination with (redundant and unnecessary) explicit JavaScript initialization of the same carousel.
Via JavaScriptCall carousel manually with:
$ (".carousel" ). carousel () OptionsOptions can be passed via data attributes or JavaScript. For data attributes, append the option name to data- , as in data-interval="" .
interval | number | 5000 | The amount of time to delay between automatically cycling an item. If false, carousel will not automatically cycle. |
keyboard | boolean | true | Whether the carousel should react to keyboard events. |
pause | string | boolean | "hover" | If set to "hover" , pauses the cycling of the carousel on mouseenter and resumes the cycling of the carousel on mouseleave . If set to false , hovering over the carousel won"t pause it. On touch-enabled devices, when set to "hover" , cycling will pause on touchend (once the user finished interacting with the carousel) for two intervals, before automatically resuming. Note that this is in addition to the above mouse behavior. |
ride | string | false | Autoplays the carousel after the user manually cycles the first item. If "carousel", autoplays the carousel on load. |
wrap | boolean | true | Whether the carousel should cycle continuously or have hard stops. |
touch | boolean | true | Whether the carousel should support left/right swipe interactions on touchscreen devices. |
All API methods are asynchronous and start a transition . They return to the caller as soon as the transition is started but before it ends . In addition, a method call on a transitioning component will be ignored .
.carousel(options)Initializes the carousel with an optional options object and starts cycling through items.
$ (".carousel" ). carousel ({ interval : 2000 }) .carousel("cycle")Cycles through the carousel items from left to right.
.carousel("pause")Stops the carousel from cycling through items.
.carousel(number)Cycles the carousel to a particular frame (0 based, similar to an array). Returns to the caller before the target item has been shown
.carousel("prev")Cycles to the previous item. Returns to the caller before the previous item has been shown (i.e. before the slid.bs.carousel event occurs).
.carousel("next")Cycles to the next item. Returns to the caller before the next item has been shown (i.e. before the slid.bs.carousel event occurs).
.carousel("dispose")Destroys an element’s carousel.
EventsBootstrap’s carousel class exposes two events for hooking into carousel functionality. Both events have the following additional properties:
- direction: The direction in which the carousel is sliding (either "left" or "right").
- relatedTarget: The DOM element that is being slid into place as the active item.
- from: The index of the current item
- to: The index of the next item
All carousel events are fired at the carousel itself (i.e. at the ).
slide.bs.carousel | This event fires immediately when the slide instance method is invoked. |
slid.bs.carousel | This event is fired when the carousel has completed its slide transition. |
The transition duration of .carousel-item can be changed with the $carousel-transition Sass variable before compiling or custom styles if you’re using the compiled CSS. If multiple transitions are applied, make sure the transform transition is defined first (eg. transition: transform 2s ease, opacity .5s ease-out).