1 год назад
История
README.md
KCSlider
Не требует подключения дополнительных библиотек.
Параметры инициализации приближены к owl слайдеру.
| Параметр | По-умолчанию | Описание |
|---|---|---|
| id | false |
(false/string) атрибут ID слайдера если false то будет сгенерирован автоматически |
| items | 1 |
(int) кол-во показываемых элементов |
| margin | 10 |
(int) отступы между элементами |
| step | 1 |
(int) шаг прокрутки элементов при использовании кнопок стрелок |
| slideTo | 0 |
(int) номер слайда который будет показываться на первом экране после загрузки начиная с 0 |
| sensitivity | 80 |
(int от 0 до 100) чувствительность прокрутки |
| sensitivityTouch | 5 |
(int кол-во пикселей смещения) чувствительность срабатывания свайпа |
| animSpeedScroll | 0.3 |
(float от 0 до 1) скорость анимации прокрутки |
| lazyLoad | true |
(true/false) включение/выключение подгрузки контента из атрибута data-src |
| loop | false |
(true/false) зацикливание прокрутки |
| pull | true |
(true/false) продолжать тянуть если слайдов больше нет |
| attrShow | false |
(true/false) заносить в атрибут data-show процент появления слайда в видимой области при вращении мышкой или touch движением |
| autoHeight | false |
(true/false) автоматическое выравнивание по высоте видимой части слайдов |
| autoplay | false |
(true/false) автоматическая прокрутка слайдов |
| autoplayTimeout | 4000 |
(число) время в миллисекундах паузы прокрутки |
| autoplayHoverPause | true |
(true/false) останавливать автоматическую прокрутку при наведении на слайдер мышкой |
| btnPlay | false |
(true/false) показывать кнопку включения/выключение авто прокрутки |
| btnStart | false |
(true/false) кнопка прокрутить слайдер в начало |
| btnEnd | false |
(true/false) кнопка прокрутить слайдер в конец |
| nav | true |
(true/false) показывать стрелки прокрутки на 1 шаг |
| clickSlide | true |
(true/false) перемещать слайд в зону видимости при клике по нему |
| slideHint | true |
(true/false) Показывать подсказку о движении слайдов |
| slideHintTimeout | 3000 |
(число) время показа подсказки о движении слайдов |
| dots | false |
(true/false) показывать точки навигации по слайдеру |
| class | {} |
(object) Дополнительные классы (для стрелок, точек, слайдера и т.д. описание ниже) |
| content | {} |
(object) html код для вставки в генерируемые элементы напрмер стрелки или точки (описание ниже) |
| responsive | {} |
(object) объект для изменения слайдера в зависимости от ширины экрана |
| events | {} |
(object) объект для установки собственных событий |
Пример иницилизация
css
<link rel="stylesheet" href="css/KCSlider.min.css">
<style>
.slideItem{
display: block;
position: relative;
width: 100%;
min-height: 100px;
}
</style>
js
<script src="js/KCSlider.min.js"></script>
html
Для назначения стандартных стилей обязательно должен присутствовать класс
kc-carousel
<div class="slider kc-carousel">
<img class="slideItem" data-src="img/100.jpeg" alt="">
<img class="slideItem" data-src="img/101.jpeg" alt="">
<img class="slideItem" data-src="img/102.jpeg" alt="">
<img class="slideItem" data-src="img/103.jpeg" alt="">
<img class="slideItem" data-src="img/104.jpeg" alt="">
<img class="slideItem" data-src="img/105.jpeg" alt="">
<img class="slideItem" data-src="img/106.jpeg" alt="">
<img class="slideItem" data-src="img/108.jpeg" alt="">
<img class="slideItem" data-src="img/109.jpeg" alt="">
</div>
Иницилизация
if(typeof KCSlider==="undefined"){window['KCSlider']={'s':[],ready(f){this.s.push(f)}}}
KCSlider.ready(()=>{
KCSlider.init('.slider.kc-carousel', {
'items':2,
'margin':15,
'autoHeight':true,
'dots':true,
'btnPlay':true,
'loop':true,
'autoplayTimeout':5000,
'responsive':{
484:3,
767:5,
991:7,
1199: {
'items':4,
'autoplay':false
},
}
});
});
Отложенный запуск
Если вы хотите выполнить свой код или иницилизировать слайдер исключительно после загрузки основной библиотеки, используйте следующий код:
if(typeof KCSlider==="undefined"){window['KCSlider']={'s':[],ready(f){this.s.push(f)}}}
KCSlider.ready(()=>{
/*ВАШ КОД*/
});
Дополнительные классы
В параметрах иницилизации можно передать строку с собственным классом для элементов сгенерированных слайдером
'class':{ // Дополнительные классы
'blockArrow':'', //Блок стрелок
'btnArrow':'', // Кнопка стрелок
'btnArrowNext':'', // Кнопка стрелки следующий слайд
'btnArrowPrep':'', // Кнопка стрелки предыдущий слайд
'blockDots':'', // Блок точек навигации
'btnDot':'', // Кнопка точки
'btnList':'', // Блок дополнительных кнопок
'btn':'', // Дополнительные кнопки
'btnNext':'', // Кнопка в конец слайдера
'btnPrep':'', // Кнопка в начало слайдера
'btnPause':'', // Кнопка в паузы автопролистывания
'item':'', // Блок слайда
'carouselLine':'', // Блок слайдов
'carouselBody':'', // Родительский блок слайдов
}
html код для вставки
В параметрах иницилизации можно передать строку с собственным html кодом, который бедет вставлен в соответсвующий элемент слайдера при генерации
'content':{ // html код для вставки
'btnArrow':'', // Кнопка стрелок
'btnArrowNext':'', // Кнопка стрелки следующий слайд
'btnArrowPrep':'', // Кнопка стрелки предыдущий слайд
'btnDot':'', // Кнопка точки (строка для всех, либо объект с содержимым по номеру начиная с 0)
'btnPause':'', // Дополнительные кнопки (строка для всех, либо объект с содержимым по номеру начиная с 0)
}
События
При иницилизации слайдера можно передать свои собственные функции для кастомизации под ваши задачи. События так же восприимчивы к изменению ширины экрана через
responsive
'events':{ //события
'onBeforeRender':function(){}, //перед рендером слайдера
'onAfterRender':function(){}, // после рендера слайдера
'onBeforeNext':function(){}, //перед пролистыванием слайдера вперед
'onAfterNext':function(){}, // после пролистывания слайдера вперед
'onBeforeBack':function(){}, //перед пролистыванием слайдера назад
'onAfterBack':function(){}, // после пролистывания слайдера назад
'onBeforeResize':function(){}, //перед изменением размера слайдера
'onAfterResize':function(){}, // после изменения размера слайдера
'onBeforePause':function(){}, // перед установкой прокрутки на паузу
'onAfterPause':function(){}, // после установки прокрутки на паузу
'onBeforePlay':function(){}, // перед началом прокрутки слайдера
'onAfterPlay':function(){}, // после начала прокрутки слайдера
'onBeforeSetSlide':function(){}, // перед тем как задается номер слайда
'onAfterSetSlide':function(){}, // после того как установился слайдер по номеру
'onBeforeMove':function(){}, // перед началом смещения слайдов
'onMove':function(){}, // смещение слайдов
'onAfterMove':function(){}, // после смещения слайдов
'onClickSlide':function(){}, // Клик по слайду
'onShowHint':function(){}, // При показе анимации подсказки свайпа слайдера
}
Пример использования
if(typeof KCSlider==="undefined"){window['KCSlider']={'s':[],ready(f){this.s.push(f)}}}
KCSlider.ready(()=>{
KCSlider.init('.slider.kc-carousel', {
'items':2,
'events':{
'onBeforeRender':function (slider){
console.log('onBeforeRender');
},
'onAfterRender':function (slider){
console.log('onAfterRender');
},
'onBeforeNext':function (slider){
console.log('onBeforeNext');
},
'onAfterNext':function (slider){
console.log('onAfterNext');
},
'onBeforeBack':function (slider){
console.log('onBeforeBack');
},
'onAfterBack':function (slider){
console.log('onAfterBack');
},
'onBeforeResize':function (slider){
console.log('onBeforeResize');
},
'onAfterResize':function (slider){
console.log('onAfterResize');
},
'onBeforePause':function (slider){
console.log('onBeforePause');
},
'onAfterPause':function (slider){
console.log('onAfterPause');
},
'onBeforePlay':function (slider){
console.log('onBeforePlay');
},
'onAfterPlay':function (slider){
console.log('onAfterPlay');
},
}
});
});
Описание
Это легковесный слайдер на чистом JavaScript, который не требует подключения дополнительных JS библиотек. Легко интегрируется и настраивается, идеально подходит для любого веб-проекта.
Конвейеры
0
успешных
0
с ошибкой