0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-04 16:24:22 +01:00
Bootstrap/js/src/carousel.js

615 lines
16 KiB
JavaScript
Raw Normal View History

2015-05-08 07:26:40 +02:00
/**
* --------------------------------------------------------------------------
2018-07-24 04:25:52 +02:00
* Bootstrap (v4.1.3): carousel.js
2015-05-08 07:26:40 +02:00
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
* --------------------------------------------------------------------------
*/
2018-10-14 13:59:51 +02:00
import $ from 'jquery'
import Util from './util'
2018-09-26 10:39:01 +02:00
/**
* ------------------------------------------------------------------------
* Constants
* ------------------------------------------------------------------------
*/
2015-05-13 23:46:50 +02:00
2018-09-26 10:39:01 +02:00
const NAME = 'carousel'
const VERSION = '4.1.3'
const DATA_KEY = 'bs.carousel'
const EVENT_KEY = `.${DATA_KEY}`
const DATA_API_KEY = '.data-api'
const JQUERY_NO_CONFLICT = $.fn[NAME]
const ARROW_LEFT_KEYCODE = 37 // KeyboardEvent.which value for left arrow key
const ARROW_RIGHT_KEYCODE = 39 // KeyboardEvent.which value for right arrow key
const TOUCHEVENT_COMPAT_WAIT = 500 // Time for mouse compat events to fire after touch
2018-10-14 13:59:51 +02:00
const SWIPE_THRESHOLD = 40
2018-09-26 10:39:01 +02:00
const Default = {
interval : 5000,
keyboard : true,
slide : false,
pause : 'hover',
wrap : true,
touch : true
2018-09-26 10:39:01 +02:00
}
const DefaultType = {
interval : '(number|boolean)',
keyboard : 'boolean',
slide : '(boolean|string)',
pause : '(string|boolean)',
wrap : 'boolean',
touch : 'boolean'
2018-09-26 10:39:01 +02:00
}
const Direction = {
NEXT : 'next',
PREV : 'prev',
LEFT : 'left',
RIGHT : 'right'
}
const Event = {
SLIDE : `slide${EVENT_KEY}`,
SLID : `slid${EVENT_KEY}`,
KEYDOWN : `keydown${EVENT_KEY}`,
MOUSEENTER : `mouseenter${EVENT_KEY}`,
MOUSELEAVE : `mouseleave${EVENT_KEY}`,
2018-10-14 13:59:51 +02:00
TOUCHSTART : `touchstart${EVENT_KEY}`,
TOUCHMOVE : `touchmove${EVENT_KEY}`,
2018-10-14 23:10:13 +02:00
TOUCHEND : `touchend${EVENT_KEY}`,
POINTERDOWN : `pointerdown${EVENT_KEY}`,
POINTERMOVE : `pointermove${EVENT_KEY}`,
POINTERUP : `pointerup${EVENT_KEY}`,
POINTERLEAVE : `pointerleave${EVENT_KEY}`,
POINTERCANCEL : `pointercancel${EVENT_KEY}`,
2018-09-26 10:39:01 +02:00
LOAD_DATA_API : `load${EVENT_KEY}${DATA_API_KEY}`,
2018-10-14 13:59:51 +02:00
CLICK_DATA_API : `click${EVENT_KEY}${DATA_API_KEY}`
2018-09-26 10:39:01 +02:00
}
const ClassName = {
2018-10-14 23:10:13 +02:00
CAROUSEL : 'carousel',
ACTIVE : 'active',
SLIDE : 'slide',
RIGHT : 'carousel-item-right',
LEFT : 'carousel-item-left',
NEXT : 'carousel-item-next',
PREV : 'carousel-item-prev',
ITEM : 'carousel-item',
POINTER_EVENT : 'pointer-event'
2018-09-26 10:39:01 +02:00
}
const Selector = {
ACTIVE : '.active',
ACTIVE_ITEM : '.active.carousel-item',
ITEM : '.carousel-item',
NEXT_PREV : '.carousel-item-next, .carousel-item-prev',
INDICATORS : '.carousel-indicators',
DATA_SLIDE : '[data-slide], [data-slide-to]',
DATA_RIDE : '[data-ride="carousel"]'
}
2015-05-08 07:26:40 +02:00
2018-10-14 23:10:13 +02:00
const PointerType = {
TOUCH : 'touch',
PEN : 'pen'
}
2018-09-26 10:39:01 +02:00
/**
* ------------------------------------------------------------------------
* Class Definition
* ------------------------------------------------------------------------
*/
class Carousel {
constructor(element, config) {
this._items = null
this._interval = null
this._activeElement = null
this._isPaused = false
this._isSliding = false
this.touchTimeout = null
2018-10-14 13:59:51 +02:00
this.touchStartX = 0
this.touchDeltaX = 0
this._config = this._getConfig(config)
this._element = element
this._indicatorsElement = this._element.querySelector(Selector.INDICATORS)
2018-10-14 23:10:13 +02:00
this._touchSupported = 'ontouchstart' in document.documentElement || navigator.maxTouchPoints > 0
this._pointerEvent = Boolean(window.PointerEvent || window.MSPointerEvent)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
this._addEventListeners()
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
// Getters
2018-09-26 10:39:01 +02:00
static get VERSION() {
return VERSION
}
2018-09-26 10:39:01 +02:00
static get Default() {
return Default
}
2018-09-26 10:39:01 +02:00
// Public
2018-09-26 10:39:01 +02:00
next() {
if (!this._isSliding) {
this._slide(Direction.NEXT)
}
2018-09-26 10:39:01 +02:00
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
nextWhenVisible() {
// Don't call next when the page isn't visible
// or the carousel or its parent isn't visible
if (!document.hidden &&
($(this._element).is(':visible') && $(this._element).css('visibility') !== 'hidden')) {
this.next()
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
prev() {
if (!this._isSliding) {
this._slide(Direction.PREV)
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
pause(event) {
if (!event) {
this._isPaused = true
}
2018-09-26 10:39:01 +02:00
if (this._element.querySelector(Selector.NEXT_PREV)) {
Util.triggerTransitionEnd(this._element)
this.cycle(true)
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
clearInterval(this._interval)
this._interval = null
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
cycle(event) {
if (!event) {
this._isPaused = false
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if (this._interval) {
2015-05-08 07:26:40 +02:00
clearInterval(this._interval)
this._interval = null
}
2018-09-26 10:39:01 +02:00
if (this._config.interval && !this._isPaused) {
this._interval = setInterval(
(document.visibilityState ? this.nextWhenVisible : this.next).bind(this),
this._config.interval
)
}
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
to(index) {
this._activeElement = this._element.querySelector(Selector.ACTIVE_ITEM)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
const activeIndex = this._getItemIndex(this._activeElement)
if (index > this._items.length - 1 || index < 0) {
return
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
if (this._isSliding) {
$(this._element).one(Event.SLID, () => this.to(index))
return
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if (activeIndex === index) {
this.pause()
this.cycle()
return
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
const direction = index > activeIndex
? Direction.NEXT
: Direction.PREV
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
this._slide(direction, this._items[index])
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +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
2018-09-26 10:39:01 +02:00
// Private
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
_getConfig(config) {
config = {
...Default,
...config
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
Util.typeCheckConfig(NAME, config, DefaultType)
return config
}
2015-05-08 07:26:40 +02:00
2018-10-14 13:59:51 +02:00
_handleSwipe() {
const absDeltax = Math.abs(this.touchDeltaX)
if (absDeltax <= SWIPE_THRESHOLD) {
return
}
const direction = absDeltax / this.touchDeltaX
// swipe left
if (direction > 0) {
this.prev()
}
// swipe right
if (direction < 0) {
this.next()
}
}
2018-09-26 10:39:01 +02:00
_addEventListeners() {
if (this._config.keyboard) {
$(this._element)
.on(Event.KEYDOWN, (event) => this._keydown(event))
2015-05-13 21:48:34 +02:00
}
2018-09-26 10:39:01 +02:00
if (this._config.pause === 'hover') {
$(this._element)
.on(Event.MOUSEENTER, (event) => this.pause(event))
.on(Event.MOUSELEAVE, (event) => this.cycle(event))
2018-10-14 13:59:51 +02:00
}
this._addTouchEventListeners()
}
_addTouchEventListeners() {
if (!this._touchSupported) {
return
}
2018-10-14 23:10:13 +02:00
const start = (event) => {
event.preventDefault()
const originEvent = event.originalEvent
if (this._pointerEvent && (originEvent.pointerType === PointerType.TOUCH || originEvent.pointerType === PointerType.PEN)) {
this.touchStartX = originEvent.clientX
} else if (!this._pointerEvent) {
this.touchStartX = originEvent.touches[0].clientX
2018-10-14 23:10:13 +02:00
}
}
2018-10-14 13:59:51 +02:00
2018-10-14 23:10:13 +02:00
const move = (event) => {
2018-10-14 13:59:51 +02:00
event.preventDefault()
// ensure swiping with one touch and not pinching
2018-10-14 23:10:13 +02:00
if (event.originalEvent.touches && event.originalEvent.touches.length > 1) {
this.touchDeltaX = 0;
2018-10-14 13:59:51 +02:00
return
}
2018-10-14 23:10:13 +02:00
if (!this._pointerEvent) {
this.touchDeltaX = event.originalEvent.touches[0].clientX - this.touchStartX
2018-10-14 23:10:13 +02:00
}
}
const end = (event) => {
if (this._pointerEvent) {
this.touchDeltaX = event.originalEvent.clientX - this.touchStartX
}
2018-10-14 13:59:51 +02:00
this._handleSwipe()
if (this._config.pause === 'hover') {
2018-09-26 10:39:01 +02:00
// If it's a touch-enabled device, mouseenter/leave are fired as
// part of the mouse compatibility events on first tap - the carousel
// would stop cycling until user tapped out of it;
// here, we listen for touchend, explicitly pause the carousel
// (as if it's the second time we tap on it, mouseenter compat event
// is NOT fired) and after a timeout (to allow for mouse compatibility
// events to fire) we explicitly restart cycling
2018-10-14 13:59:51 +02:00
this.pause()
if (this.touchTimeout) {
clearTimeout(this.touchTimeout)
}
this.touchTimeout = setTimeout((event) => this.cycle(event), TOUCHEVENT_COMPAT_WAIT + this._config.interval)
}
2018-10-14 23:10:13 +02:00
}
if (this._pointerEvent) {
$(this._element).on(Event.POINTERDOWN, (event) => start(event))
$(this._element).on(Event.POINTERUP, (event) => end(event))
$(this._element).on(Event.POINTERCANCEL, (event) => end(event))
this._element.classList.add(ClassName.POINTER_EVENT)
} else {
$(this._element).on(Event.TOUCHSTART, (event) => start(event))
$(this._element).on(Event.TOUCHMOVE, (event) => move(event))
$(this._element).on(Event.TOUCHEND, (event) => end(event))
}
2018-09-26 10:39:01 +02:00
}
2015-05-13 23:46:50 +02:00
2018-09-26 10:39:01 +02:00
_keydown(event) {
if (/input|textarea/i.test(event.target.tagName)) {
return
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
switch (event.which) {
case ARROW_LEFT_KEYCODE:
event.preventDefault()
this.prev()
break
case ARROW_RIGHT_KEYCODE:
event.preventDefault()
this.next()
break
default:
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
_getItemIndex(element) {
this._items = element && element.parentNode
? [].slice.call(element.parentNode.querySelectorAll(Selector.ITEM))
: []
return this._items.indexOf(element)
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
_getItemByDirection(direction, activeElement) {
const isNextDirection = direction === Direction.NEXT
const isPrevDirection = direction === Direction.PREV
const activeIndex = this._getItemIndex(activeElement)
const lastItemIndex = this._items.length - 1
const isGoingToWrap = isPrevDirection && activeIndex === 0 ||
isNextDirection && activeIndex === lastItemIndex
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if (isGoingToWrap && !this._config.wrap) {
return activeElement
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
const delta = direction === Direction.PREV ? -1 : 1
const itemIndex = (activeIndex + delta) % this._items.length
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
return itemIndex === -1
? this._items[this._items.length - 1] : this._items[itemIndex]
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
_triggerSlideEvent(relatedTarget, eventDirectionName) {
const targetIndex = this._getItemIndex(relatedTarget)
const fromIndex = this._getItemIndex(this._element.querySelector(Selector.ACTIVE_ITEM))
const slideEvent = $.Event(Event.SLIDE, {
relatedTarget,
direction: eventDirectionName,
from: fromIndex,
to: targetIndex
})
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
$(this._element).trigger(slideEvent)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
return slideEvent
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
_setActiveIndicatorElement(element) {
if (this._indicatorsElement) {
const indicators = [].slice.call(this._indicatorsElement.querySelectorAll(Selector.ACTIVE))
$(indicators)
.removeClass(ClassName.ACTIVE)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
const nextIndicator = this._indicatorsElement.children[
this._getItemIndex(element)
]
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if (nextIndicator) {
$(nextIndicator).addClass(ClassName.ACTIVE)
2015-05-08 07:26:40 +02:00
}
}
2018-09-26 10:39:01 +02:00
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
_slide(direction, element) {
const activeElement = this._element.querySelector(Selector.ACTIVE_ITEM)
const activeElementIndex = this._getItemIndex(activeElement)
const nextElement = element || activeElement &&
this._getItemByDirection(direction, activeElement)
const nextElementIndex = this._getItemIndex(nextElement)
const isCycling = Boolean(this._interval)
let directionalClassName
let orderClassName
let eventDirectionName
if (direction === Direction.NEXT) {
directionalClassName = ClassName.LEFT
orderClassName = ClassName.NEXT
eventDirectionName = Direction.LEFT
} else {
directionalClassName = ClassName.RIGHT
orderClassName = ClassName.PREV
eventDirectionName = Direction.RIGHT
}
2016-12-05 04:53:16 +01:00
2018-09-26 10:39:01 +02:00
if (nextElement && $(nextElement).hasClass(ClassName.ACTIVE)) {
this._isSliding = false
return
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
const slideEvent = this._triggerSlideEvent(nextElement, eventDirectionName)
if (slideEvent.isDefaultPrevented()) {
return
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if (!activeElement || !nextElement) {
// Some weirdness is happening, so we bail
return
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
this._isSliding = true
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if (isCycling) {
this.pause()
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
this._setActiveIndicatorElement(nextElement)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
const slidEvent = $.Event(Event.SLID, {
relatedTarget: nextElement,
direction: eventDirectionName,
from: activeElementIndex,
to: nextElementIndex
})
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if ($(this._element).hasClass(ClassName.SLIDE)) {
$(nextElement).addClass(orderClassName)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
Util.reflow(nextElement)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
$(activeElement).addClass(directionalClassName)
$(nextElement).addClass(directionalClassName)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
const nextElementInterval = parseInt(nextElement.getAttribute('data-interval'), 10)
if (nextElementInterval) {
this._config.defaultInterval = this._config.defaultInterval || this._config.interval
this._config.interval = nextElementInterval
} else {
this._config.interval = this._config.defaultInterval || this._config.interval
}
2018-09-26 10:39:01 +02:00
const transitionDuration = Util.getTransitionDurationFromElement(activeElement)
2018-03-13 09:59:20 +01:00
2018-09-26 10:39:01 +02:00
$(activeElement)
.one(Util.TRANSITION_END, () => {
$(nextElement)
.removeClass(`${directionalClassName} ${orderClassName}`)
.addClass(ClassName.ACTIVE)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
$(activeElement).removeClass(`${ClassName.ACTIVE} ${orderClassName} ${directionalClassName}`)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
this._isSliding = false
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
setTimeout(() => $(this._element).trigger(slidEvent), 0)
})
.emulateTransitionEnd(transitionDuration)
} else {
$(activeElement).removeClass(ClassName.ACTIVE)
$(nextElement).addClass(ClassName.ACTIVE)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
this._isSliding = false
$(this._element).trigger(slidEvent)
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if (isCycling) {
this.cycle()
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
// Static
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
static _jQueryInterface(config) {
return this.each(function () {
let data = $(this).data(DATA_KEY)
let _config = {
...Default,
...$(this).data()
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if (typeof config === 'object') {
_config = {
..._config,
...config
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
const action = typeof config === 'string' ? config : _config.slide
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if (!data) {
data = new Carousel(this, _config)
$(this).data(DATA_KEY, data)
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if (typeof config === 'number') {
data.to(config)
} else if (typeof action === 'string') {
if (typeof data[action] === 'undefined') {
throw new TypeError(`No method named "${action}"`)
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
data[action]()
} else if (_config.interval) {
data.pause()
data.cycle()
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
})
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
static _dataApiClickHandler(event) {
const selector = Util.getSelectorFromElement(this)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if (!selector) {
return
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
const target = $(selector)[0]
2015-08-19 04:22:46 +02:00
2018-09-26 10:39:01 +02:00
if (!target || !$(target).hasClass(ClassName.CAROUSEL)) {
return
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
const config = {
...$(target).data(),
...$(this).data()
}
const slideIndex = this.getAttribute('data-slide-to')
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if (slideIndex) {
config.interval = false
}
Carousel._jQueryInterface.call($(target), config)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
if (slideIndex) {
$(target).data(DATA_KEY).to(slideIndex)
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
event.preventDefault()
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
}
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
/**
* ------------------------------------------------------------------------
* Data Api implementation
* ------------------------------------------------------------------------
*/
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
$(document)
.on(Event.CLICK_DATA_API, Selector.DATA_SLIDE, Carousel._dataApiClickHandler)
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
$(window).on(Event.LOAD_DATA_API, () => {
const carousels = [].slice.call(document.querySelectorAll(Selector.DATA_RIDE))
for (let i = 0, len = carousels.length; i < len; i++) {
const $carousel = $(carousels[i])
Carousel._jQueryInterface.call($carousel, $carousel.data())
2015-05-08 07:26:40 +02:00
}
2018-09-26 10:39:01 +02:00
})
/**
* ------------------------------------------------------------------------
* jQuery
* ------------------------------------------------------------------------
*/
2015-05-08 07:26:40 +02:00
2018-09-26 10:39:01 +02:00
$.fn[NAME] = Carousel._jQueryInterface
$.fn[NAME].Constructor = Carousel
$.fn[NAME].noConflict = () => {
$.fn[NAME] = JQUERY_NO_CONFLICT
return Carousel._jQueryInterface
}
2015-05-08 07:26:40 +02:00
export default Carousel