carousel.js 12.8 KB
Newer Older
fat's avatar
fat committed
1
2
3
4
5
import Util from './util'


/**
 * --------------------------------------------------------------------------
Mark Otto's avatar
Mark Otto committed
6
 * Bootstrap (v4.0.0-alpha.6): carousel.js
fat's avatar
fat committed
7
8
9
10
11
12
13
14
15
16
17
18
19
20
 * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
 * --------------------------------------------------------------------------
 */

const Carousel = (($) => {


  /**
   * ------------------------------------------------------------------------
   * Constants
   * ------------------------------------------------------------------------
   */

  const NAME                = 'carousel'
Mark Otto's avatar
Mark Otto committed
21
  const VERSION             = '4.0.0-alpha.6'
fat's avatar
fat committed
22
  const DATA_KEY            = 'bs.carousel'
fat's avatar
fat committed
23
24
  const EVENT_KEY           = `.${DATA_KEY}`
  const DATA_API_KEY        = '.data-api'
fat's avatar
fat committed
25
26
  const JQUERY_NO_CONFLICT  = $.fn[NAME]
  const TRANSITION_DURATION = 600
27
28
  const ARROW_LEFT_KEYCODE  = 37 // KeyboardEvent.which value for left arrow key
  const ARROW_RIGHT_KEYCODE = 39 // KeyboardEvent.which value for right arrow key
fat's avatar
fat committed
29

30
  const Default = {
fat's avatar
fat committed
31
32
33
34
35
36
37
    interval : 5000,
    keyboard : true,
    slide    : false,
    pause    : 'hover',
    wrap     : true
  }

fat's avatar
fat committed
38
39
40
41
42
43
44
45
  const DefaultType = {
    interval : '(number|boolean)',
    keyboard : 'boolean',
    slide    : '(boolean|string)',
    pause    : '(string|boolean)',
    wrap     : 'boolean'
  }

fat's avatar
fat committed
46
47
  const Direction = {
    NEXT     : 'next',
Mark Otto's avatar
Mark Otto committed
48
    PREV     : 'prev',
Mark Otto's avatar
Mark Otto committed
49
50
    LEFT     : 'left',
    RIGHT    : 'right'
fat's avatar
fat committed
51
52
53
  }

  const Event = {
fat's avatar
fat committed
54
55
56
57
58
59
60
    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}`
fat's avatar
fat committed
61
62
63
64
65
66
  }

  const ClassName = {
    CAROUSEL : 'carousel',
    ACTIVE   : 'active',
    SLIDE    : 'slide',
Mark Otto's avatar
Mark Otto committed
67
68
69
    RIGHT    : 'carousel-item-right',
    LEFT     : 'carousel-item-left',
    NEXT     : 'carousel-item-next',
Mark Otto's avatar
Mark Otto committed
70
    PREV     : 'carousel-item-prev',
fat's avatar
fat committed
71
72
73
74
75
76
77
    ITEM     : 'carousel-item'
  }

  const Selector = {
    ACTIVE      : '.active',
    ACTIVE_ITEM : '.active.carousel-item',
    ITEM        : '.carousel-item',
Mark Otto's avatar
Mark Otto committed
78
    NEXT_PREV   : '.carousel-item-next, .carousel-item-prev',
fat's avatar
fat committed
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
    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

fat's avatar
fat committed
101
      this._config            = this._getConfig(config)
fat's avatar
fat committed
102
103
104
105
      this._element           = $(element)[0]
      this._indicatorsElement = $(this._element).find(Selector.INDICATORS)[0]

      this._addEventListeners()
106
107
108
109
110
111
112
113
    }


    // getters

    static get VERSION() {
      return VERSION
    }
fat's avatar
fat committed
114

115
116
    static get Default() {
      return Default
fat's avatar
fat committed
117
118
119
120
121
122
    }


    // public

    next() {
123
124
      if (!this._isSliding) {
        this._slide(Direction.NEXT)
fat's avatar
fat committed
125
126
127
      }
    }

128
129
130
131
132
133
134
    nextWhenVisible() {
      // Don't call next when the page isn't visible
      if (!document.hidden) {
        this.next()
      }
    }

fat's avatar
fat committed
135
    prev() {
136
137
      if (!this._isSliding) {
        this._slide(Direction.PREV)
fat's avatar
fat committed
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
      }
    }

    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(
168
169
          (document.visibilityState ? this.nextWhenVisible : this.next).bind(this),
          this._config.interval
fat's avatar
fat committed
170
171
172
173
174
175
176
        )
      }
    }

    to(index) {
      this._activeElement = $(this._element).find(Selector.ACTIVE_ITEM)[0]

177
      const activeIndex = this._getItemIndex(this._activeElement)
fat's avatar
fat committed
178

179
      if (index > this._items.length - 1 || index < 0) {
fat's avatar
fat committed
180
181
182
183
184
185
186
187
        return
      }

      if (this._isSliding) {
        $(this._element).one(Event.SLID, () => this.to(index))
        return
      }

Jacob Thornton's avatar
Jacob Thornton committed
188
      if (activeIndex === index) {
fat's avatar
fat committed
189
190
191
192
193
        this.pause()
        this.cycle()
        return
      }

194
      const direction = index > activeIndex ?
fat's avatar
fat committed
195
        Direction.NEXT :
196
        Direction.PREV
fat's avatar
fat committed
197
198
199
200

      this._slide(direction, this._items[index])
    }

fat's avatar
fat committed
201
202
203
204
205
206
207
208
209
210
211
212
213
214
    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
    }

fat's avatar
fat committed
215
216
217

    // private

fat's avatar
fat committed
218
219
220
221
222
223
    _getConfig(config) {
      config = $.extend({}, Default, config)
      Util.typeCheckConfig(NAME, config, DefaultType)
      return config
    }

fat's avatar
fat committed
224
225
226
    _addEventListeners() {
      if (this._config.keyboard) {
        $(this._element)
227
          .on(Event.KEYDOWN, (event) => this._keydown(event))
fat's avatar
fat committed
228
229
      }

Jacob Thornton's avatar
Jacob Thornton committed
230
      if (this._config.pause === 'hover' &&
fat's avatar
fat committed
231
232
        !('ontouchstart' in document.documentElement)) {
        $(this._element)
233
234
          .on(Event.MOUSEENTER, (event) => this.pause(event))
          .on(Event.MOUSELEAVE, (event) => this.cycle(event))
fat's avatar
fat committed
235
236
237
238
      }
    }

    _keydown(event) {
Jacob Thornton's avatar
Jacob Thornton committed
239
240
241
      if (/input|textarea/i.test(event.target.tagName)) {
        return
      }
fat's avatar
fat committed
242
243

      switch (event.which) {
244
        case ARROW_LEFT_KEYCODE:
245
          event.preventDefault()
246
247
248
          this.prev()
          break
        case ARROW_RIGHT_KEYCODE:
249
          event.preventDefault()
250
251
252
253
          this.next()
          break
        default:
          return
fat's avatar
fat committed
254
255
256
257
258
259
260
261
262
      }
    }

    _getItemIndex(element) {
      this._items = $.makeArray($(element).parent().find(Selector.ITEM))
      return this._items.indexOf(element)
    }

    _getItemByDirection(direction, activeElement) {
263
      const isNextDirection = direction === Direction.NEXT
264
      const isPrevDirection = direction === Direction.PREV
265
266
267
268
      const activeIndex     = this._getItemIndex(activeElement)
      const lastItemIndex   = this._items.length - 1
      const isGoingToWrap   = isPrevDirection && activeIndex === 0 ||
                              isNextDirection && activeIndex === lastItemIndex
fat's avatar
fat committed
269
270
271
272
273

      if (isGoingToWrap && !this._config.wrap) {
        return activeElement
      }

274
      const delta     = direction === Direction.PREV ? -1 : 1
275
      const itemIndex = (activeIndex + delta) % this._items.length
fat's avatar
fat committed
276
277
278
279
280
281

      return itemIndex === -1 ?
        this._items[this._items.length - 1] : this._items[itemIndex]
    }


Mark Otto's avatar
Mark Otto committed
282
    _triggerSlideEvent(relatedTarget, eventDirectionName) {
283
284
      const targetIndex = this._getItemIndex(relatedTarget)
      const fromIndex = this._getItemIndex($(this._element).find(Selector.ACTIVE_ITEM)[0])
285
      const slideEvent = $.Event(Event.SLIDE, {
Jacob Thornton's avatar
Jacob Thornton committed
286
        relatedTarget,
287
288
289
        direction: eventDirectionName,
        from: fromIndex,
        to: targetIndex
fat's avatar
fat committed
290
291
292
293
294
295
296
297
298
299
300
301
302
      })

      $(this._element).trigger(slideEvent)

      return slideEvent
    }

    _setActiveIndicatorElement(element) {
      if (this._indicatorsElement) {
        $(this._indicatorsElement)
          .find(Selector.ACTIVE)
          .removeClass(ClassName.ACTIVE)

303
        const nextIndicator = this._indicatorsElement.children[
fat's avatar
fat committed
304
305
306
307
308
309
310
311
312
313
          this._getItemIndex(element)
        ]

        if (nextIndicator) {
          $(nextIndicator).addClass(ClassName.ACTIVE)
        }
      }
    }

    _slide(direction, element) {
314
      const activeElement = $(this._element).find(Selector.ACTIVE_ITEM)[0]
315
      const activeElementIndex = this._getItemIndex(activeElement)
316
      const nextElement   = element || activeElement &&
fat's avatar
fat committed
317
        this._getItemByDirection(direction, activeElement)
318
      const nextElementIndex = this._getItemIndex(nextElement)
319
      const isCycling = Boolean(this._interval)
fat's avatar
fat committed
320

Mark Otto's avatar
Mark Otto committed
321
322
323
324
325
326
327
328
329
330
331
332
333
334
      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
      }

fat's avatar
fat committed
335
336
337
338
339
      if (nextElement && $(nextElement).hasClass(ClassName.ACTIVE)) {
        this._isSliding = false
        return
      }

Mark Otto's avatar
Mark Otto committed
340
      const slideEvent = this._triggerSlideEvent(nextElement, eventDirectionName)
fat's avatar
fat committed
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
      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)

358
      const slidEvent = $.Event(Event.SLID, {
fat's avatar
fat committed
359
        relatedTarget: nextElement,
360
361
362
        direction: eventDirectionName,
        from: activeElementIndex,
        to: nextElementIndex
fat's avatar
fat committed
363
364
365
366
367
      })

      if (Util.supportsTransitionEnd() &&
        $(this._element).hasClass(ClassName.SLIDE)) {

Mark Otto's avatar
Mark Otto committed
368
        $(nextElement).addClass(orderClassName)
fat's avatar
fat committed
369
370
371
372
373
374
375
376
377

        Util.reflow(nextElement)

        $(activeElement).addClass(directionalClassName)
        $(nextElement).addClass(directionalClassName)

        $(activeElement)
          .one(Util.TRANSITION_END, () => {
            $(nextElement)
378
              .removeClass(`${directionalClassName} ${orderClassName}`)
J2TeaM's avatar
J2TeaM committed
379
              .addClass(ClassName.ACTIVE)
fat's avatar
fat committed
380

381
            $(activeElement).removeClass(`${ClassName.ACTIVE} ${orderClassName} ${directionalClassName}`)
fat's avatar
fat committed
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407

            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 () {
Jacob Thornton's avatar
Jacob Thornton committed
408
        let data      = $(this).data(DATA_KEY)
409
        const _config = $.extend({}, Default, $(this).data())
fat's avatar
fat committed
410
411
412
413
414

        if (typeof config === 'object') {
          $.extend(_config, config)
        }

415
        const action = typeof config === 'string' ? config : _config.slide
fat's avatar
fat committed
416
417
418
419
420
421

        if (!data) {
          data = new Carousel(this, _config)
          $(this).data(DATA_KEY, data)
        }

Jacob Thornton's avatar
Jacob Thornton committed
422
        if (typeof config === 'number') {
fat's avatar
fat committed
423
          data.to(config)
424
425
426
427
        } else if (typeof action === 'string') {
          if (data[action] === undefined) {
            throw new Error(`No method named "${action}"`)
          }
fat's avatar
fat committed
428
429
430
431
432
433
434
435
436
          data[action]()
        } else if (_config.interval) {
          data.pause()
          data.cycle()
        }
      })
    }

    static _dataApiClickHandler(event) {
437
      const selector = Util.getSelectorFromElement(this)
fat's avatar
fat committed
438
439
440
441
442

      if (!selector) {
        return
      }

443
      const target = $(selector)[0]
fat's avatar
fat committed
444
445
446
447
448

      if (!target || !$(target).hasClass(ClassName.CAROUSEL)) {
        return
      }

449
450
      const config     = $.extend({}, $(target).data(), $(this).data())
      const slideIndex = this.getAttribute('data-slide-to')
Jacob Thornton's avatar
Jacob Thornton committed
451

fat's avatar
fat committed
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
      if (slideIndex) {
        config.interval = false
      }

      Carousel._jQueryInterface.call($(target), config)

      if (slideIndex) {
        $(target).data(DATA_KEY).to(slideIndex)
      }

      event.preventDefault()
    }

  }


  /**
   * ------------------------------------------------------------------------
   * Data Api implementation
   * ------------------------------------------------------------------------
   */

  $(document)
fat's avatar
fat committed
475
    .on(Event.CLICK_DATA_API, Selector.DATA_SLIDE, Carousel._dataApiClickHandler)
fat's avatar
fat committed
476

Jacob Thornton's avatar
Jacob Thornton committed
477
  $(window).on(Event.LOAD_DATA_API, () => {
fat's avatar
fat committed
478
    $(Selector.DATA_RIDE).each(function () {
479
      const $carousel = $(this)
fat's avatar
fat committed
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
      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