0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-13 01:08:58 +01:00
Bootstrap/js/src/carousel.js

479 lines
12 KiB
JavaScript
Raw Normal View History

2015-05-08 07:26:40 +02:00
import Util from './util'
/**
* --------------------------------------------------------------------------
* Bootstrap (v4.0.0-alpha): carousel.js
2015-05-08 07:26:40 +02:00
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
* --------------------------------------------------------------------------
*/
const Carousel = (($) => {
/**
* ------------------------------------------------------------------------
* Constants
* ------------------------------------------------------------------------
*/
const NAME = 'carousel'
const VERSION = '4.0.0-alpha'
2015-05-08 07:26:40 +02:00
const DATA_KEY = 'bs.carousel'
2015-05-13 21:48:34 +02:00
const EVENT_KEY = `.${DATA_KEY}`
const DATA_API_KEY = '.data-api'
2015-05-08 07:26:40 +02:00
const JQUERY_NO_CONFLICT = $.fn[NAME]
const TRANSITION_DURATION = 600
const Default = {
2015-05-08 07:26:40 +02:00
interval : 5000,
keyboard : true,
slide : false,
pause : 'hover',
wrap : true
}
2015-05-13 23:46:50 +02:00
const DefaultType = {
interval : '(number|boolean)',
keyboard : 'boolean',
slide : '(boolean|string)',
pause : '(string|boolean)',
wrap : 'boolean'
}
2015-05-08 07:26:40 +02:00
const Direction = {
NEXT : 'next',
PREVIOUS : 'prev'
}
const Event = {
2015-05-13 21:48:34 +02:00
SLIDE : `slide${EVENT_KEY}`,
SLID : `slid${EVENT_KEY}`,
KEYDOWN : `keydown${EVENT_KEY}`,
MOUSEENTER : `mouseenter${EVENT_KEY}`,
MOUSELEAVE : `mouseleave${EVENT_KEY}`,
LOAD_DATA_API : `load${EVENT_KEY}${DATA_API_KEY}`,
CLICK_DATA_API : `click${EVENT_KEY}${DATA_API_KEY}`
2015-05-08 07:26:40 +02:00
}
const ClassName = {
CAROUSEL : 'carousel',
ACTIVE : 'active',
SLIDE : 'slide',
RIGHT : 'right',
LEFT : 'left',
ITEM : 'carousel-item'
}
const Selector = {
ACTIVE : '.active',
ACTIVE_ITEM : '.active.carousel-item',
ITEM : '.carousel-item',
NEXT_PREV : '.next, .prev',
INDICATORS : '.carousel-indicators',
DATA_SLIDE : '[data-slide], [data-slide-to]',
DATA_RIDE : '[data-ride="carousel"]'
}
/**
* ------------------------------------------------------------------------
* Class Definition
* ------------------------------------------------------------------------
*/
class Carousel {
constructor(element, config) {
this._items = null
this._interval = null
this._activeElement = null
this._isPaused = false
this._isSliding = false
2015-05-13 23:46:50 +02:00
this._config = this._getConfig(config)
2015-05-08 07:26:40 +02:00
this._element = $(element)[0]
this._indicatorsElement = $(this._element).find(Selector.INDICATORS)[0]
this._addEventListeners()
}
// getters
static get VERSION() {
return VERSION
}
2015-05-08 07:26:40 +02:00
static get Default() {
return Default
2015-05-08 07:26:40 +02:00
}
// public
next() {
if (!this._isSliding) {
this._slide(Direction.NEXT)
}
}
nextWhenVisible() {
// Don't call next when the page isn't visible
if (!document.hidden) {
this.next()
}
}
2015-05-08 07:26:40 +02:00
prev() {
if (!this._isSliding) {
this._slide(Direction.PREVIOUS)
}
}
pause(event) {
if (!event) {
this._isPaused = true
}
if ($(this._element).find(Selector.NEXT_PREV)[0] &&
Util.supportsTransitionEnd()) {
Util.triggerTransitionEnd(this._element)
this.cycle(true)
}
clearInterval(this._interval)
this._interval = null
}
cycle(event) {
if (!event) {
this._isPaused = false
}
if (this._interval) {
clearInterval(this._interval)
this._interval = null
}
if (this._config.interval && !this._isPaused) {
this._interval = setInterval(
$.proxy(document.visibilityState ? this.nextWhenVisible : this.next, this), this._config.interval
2015-05-08 07:26:40 +02:00
)
}
}
to(index) {
this._activeElement = $(this._element).find(Selector.ACTIVE_ITEM)[0]
let activeIndex = this._getItemIndex(this._activeElement)
if (index > (this._items.length - 1) || index < 0) {
return
}
if (this._isSliding) {
$(this._element).one(Event.SLID, () => this.to(index))
return
}
2015-08-19 04:22:46 +02:00
if (activeIndex === index) {
2015-05-08 07:26:40 +02:00
this.pause()
this.cycle()
return
}
2015-08-19 04:22:46 +02:00
let direction = index > activeIndex ?
2015-05-08 07:26:40 +02:00
Direction.NEXT :
Direction.PREVIOUS
this._slide(direction, this._items[index])
}
2015-05-13 21:48:34 +02:00
dispose() {
$(this._element).off(EVENT_KEY)
$.removeData(this._element, DATA_KEY)
this._items = null
this._config = null
this._element = null
this._interval = null
this._isPaused = null
this._isSliding = null
this._activeElement = null
this._indicatorsElement = null
}
2015-05-08 07:26:40 +02:00
// private
2015-05-13 23:46:50 +02:00
_getConfig(config) {
config = $.extend({}, Default, config)
Util.typeCheckConfig(NAME, config, DefaultType)
return config
}
2015-05-08 07:26:40 +02:00
_addEventListeners() {
if (this._config.keyboard) {
$(this._element)
2015-05-13 21:48:34 +02:00
.on(Event.KEYDOWN, $.proxy(this._keydown, this))
2015-05-08 07:26:40 +02:00
}
2015-08-19 04:22:46 +02:00
if (this._config.pause === 'hover' &&
2015-05-08 07:26:40 +02:00
!('ontouchstart' in document.documentElement)) {
$(this._element)
2015-05-13 21:48:34 +02:00
.on(Event.MOUSEENTER, $.proxy(this.pause, this))
.on(Event.MOUSELEAVE, $.proxy(this.cycle, this))
2015-05-08 07:26:40 +02:00
}
}
_keydown(event) {
event.preventDefault()
2015-08-19 04:22:46 +02:00
if (/input|textarea/i.test(event.target.tagName)) {
return
}
2015-05-08 07:26:40 +02:00
switch (event.which) {
case 37: this.prev(); break
case 39: this.next(); break
default: return
}
}
_getItemIndex(element) {
this._items = $.makeArray($(element).parent().find(Selector.ITEM))
return this._items.indexOf(element)
}
_getItemByDirection(direction, activeElement) {
let isNextDirection = direction === Direction.NEXT
let isPrevDirection = direction === Direction.PREVIOUS
let activeIndex = this._getItemIndex(activeElement)
let lastItemIndex = (this._items.length - 1)
let isGoingToWrap = (isPrevDirection && activeIndex === 0) ||
2015-08-19 04:22:46 +02:00
(isNextDirection && activeIndex === lastItemIndex)
2015-05-08 07:26:40 +02:00
if (isGoingToWrap && !this._config.wrap) {
return activeElement
}
2015-08-19 04:22:46 +02:00
let delta = direction === Direction.PREVIOUS ? -1 : 1
2015-05-08 07:26:40 +02:00
let itemIndex = (activeIndex + delta) % this._items.length
return itemIndex === -1 ?
this._items[this._items.length - 1] : this._items[itemIndex]
}
_triggerSlideEvent(relatedTarget, directionalClassname) {
let slideEvent = $.Event(Event.SLIDE, {
2015-08-19 04:22:46 +02:00
relatedTarget,
2015-05-08 07:26:40 +02:00
direction: directionalClassname
})
$(this._element).trigger(slideEvent)
return slideEvent
}
_setActiveIndicatorElement(element) {
if (this._indicatorsElement) {
$(this._indicatorsElement)
.find(Selector.ACTIVE)
.removeClass(ClassName.ACTIVE)
let nextIndicator = this._indicatorsElement.children[
this._getItemIndex(element)
]
if (nextIndicator) {
$(nextIndicator).addClass(ClassName.ACTIVE)
}
}
}
_slide(direction, element) {
let activeElement = $(this._element).find(Selector.ACTIVE_ITEM)[0]
let nextElement = element || activeElement &&
this._getItemByDirection(direction, activeElement)
2015-08-19 04:22:46 +02:00
let isCycling = Boolean(this._interval)
2015-05-08 07:26:40 +02:00
2015-08-19 04:22:46 +02:00
let directionalClassName = direction === Direction.NEXT ?
2015-05-08 07:26:40 +02:00
ClassName.LEFT :
ClassName.RIGHT
if (nextElement && $(nextElement).hasClass(ClassName.ACTIVE)) {
this._isSliding = false
return
}
let slideEvent = this._triggerSlideEvent(nextElement, directionalClassName)
if (slideEvent.isDefaultPrevented()) {
return
}
if (!activeElement || !nextElement) {
// some weirdness is happening, so we bail
return
}
this._isSliding = true
if (isCycling) {
this.pause()
}
this._setActiveIndicatorElement(nextElement)
2015-08-19 04:22:46 +02:00
let slidEvent = $.Event(Event.SLID, {
2015-05-08 07:26:40 +02:00
relatedTarget: nextElement,
direction: directionalClassName
})
if (Util.supportsTransitionEnd() &&
$(this._element).hasClass(ClassName.SLIDE)) {
$(nextElement).addClass(direction)
Util.reflow(nextElement)
$(activeElement).addClass(directionalClassName)
$(nextElement).addClass(directionalClassName)
$(activeElement)
.one(Util.TRANSITION_END, () => {
$(nextElement)
.removeClass(directionalClassName)
.removeClass(direction)
$(nextElement).addClass(ClassName.ACTIVE)
$(activeElement)
.removeClass(ClassName.ACTIVE)
.removeClass(direction)
.removeClass(directionalClassName)
this._isSliding = false
setTimeout(() => $(this._element).trigger(slidEvent), 0)
})
.emulateTransitionEnd(TRANSITION_DURATION)
} else {
$(activeElement).removeClass(ClassName.ACTIVE)
$(nextElement).addClass(ClassName.ACTIVE)
this._isSliding = false
$(this._element).trigger(slidEvent)
}
if (isCycling) {
this.cycle()
}
}
// static
static _jQueryInterface(config) {
return this.each(function () {
2015-08-19 04:22:46 +02:00
let data = $(this).data(DATA_KEY)
let _config = $.extend({}, Default, $(this).data())
2015-05-08 07:26:40 +02:00
if (typeof config === 'object') {
$.extend(_config, config)
}
let action = typeof config === 'string' ? config : _config.slide
if (!data) {
data = new Carousel(this, _config)
$(this).data(DATA_KEY, data)
}
2015-08-19 04:22:46 +02:00
if (typeof config === 'number') {
2015-05-08 07:26:40 +02:00
data.to(config)
} else if (typeof action === 'string') {
if (data[action] === undefined) {
throw new Error(`No method named "${action}"`)
}
2015-05-08 07:26:40 +02:00
data[action]()
} else if (_config.interval) {
data.pause()
data.cycle()
}
})
}
static _dataApiClickHandler(event) {
let selector = Util.getSelectorFromElement(this)
if (!selector) {
return
}
let target = $(selector)[0]
if (!target || !$(target).hasClass(ClassName.CAROUSEL)) {
return
}
2015-08-19 04:22:46 +02:00
let config = $.extend({}, $(target).data(), $(this).data())
2015-05-08 07:26:40 +02:00
let slideIndex = this.getAttribute('data-slide-to')
2015-08-19 04:22:46 +02:00
2015-05-08 07:26:40 +02:00
if (slideIndex) {
config.interval = false
}
Carousel._jQueryInterface.call($(target), config)
if (slideIndex) {
$(target).data(DATA_KEY).to(slideIndex)
}
event.preventDefault()
}
}
/**
* ------------------------------------------------------------------------
* Data Api implementation
* ------------------------------------------------------------------------
*/
$(document)
2015-05-13 21:48:34 +02:00
.on(Event.CLICK_DATA_API, Selector.DATA_SLIDE, Carousel._dataApiClickHandler)
2015-05-08 07:26:40 +02:00
2015-08-19 04:22:46 +02:00
$(window).on(Event.LOAD_DATA_API, () => {
2015-05-08 07:26:40 +02:00
$(Selector.DATA_RIDE).each(function () {
let $carousel = $(this)
Carousel._jQueryInterface.call($carousel, $carousel.data())
})
})
/**
* ------------------------------------------------------------------------
* jQuery
* ------------------------------------------------------------------------
*/
$.fn[NAME] = Carousel._jQueryInterface
$.fn[NAME].Constructor = Carousel
$.fn[NAME].noConflict = function () {
$.fn[NAME] = JQUERY_NO_CONFLICT
return Carousel._jQueryInterface
}
return Carousel
})(jQuery)
export default Carousel