123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531 |
- 'use strict';
- import $ from 'jquery';
- import { Keyboard } from './foundation.util.keyboard';
- import { Motion } from './foundation.util.motion';
- import { Timer } from './foundation.util.timer';
- import { onImagesLoaded } from './foundation.util.imageLoader';
- import { GetYoDigits } from './foundation.core.utils';
- import { Plugin } from './foundation.core.plugin';
- import { Touch } from './foundation.util.touch'
- /**
- * Orbit module.
- * @module foundation.orbit
- * @requires foundation.util.keyboard
- * @requires foundation.util.motion
- * @requires foundation.util.timer
- * @requires foundation.util.imageLoader
- * @requires foundation.util.touch
- */
- class Orbit extends Plugin {
- /**
- * Creates a new instance of an orbit carousel.
- * @class
- * @name Orbit
- * @param {jQuery} element - jQuery object to make into an Orbit Carousel.
- * @param {Object} options - Overrides to the default plugin settings.
- */
- _setup(element, options){
- this.$element = element;
- this.options = $.extend({}, Orbit.defaults, this.$element.data(), options);
- this.className = 'Orbit'; // ie9 back compat
- Touch.init($); // Touch init is idempotent, we just need to make sure it's initialied.
- this._init();
- Keyboard.register('Orbit', {
- 'ltr': {
- 'ARROW_RIGHT': 'next',
- 'ARROW_LEFT': 'previous'
- },
- 'rtl': {
- 'ARROW_LEFT': 'next',
- 'ARROW_RIGHT': 'previous'
- }
- });
- }
- /**
- * Initializes the plugin by creating jQuery collections, setting attributes, and starting the animation.
- * @function
- * @private
- */
- _init() {
- // @TODO: consider discussion on PR #9278 about DOM pollution by changeSlide
- this._reset();
- this.$wrapper = this.$element.find(`.${this.options.containerClass}`);
- this.$slides = this.$element.find(`.${this.options.slideClass}`);
- var $images = this.$element.find('img'),
- initActive = this.$slides.filter('.is-active'),
- id = this.$element[0].id || GetYoDigits(6, 'orbit');
- this.$element.attr({
- 'data-resize': id,
- 'id': id
- });
- if (!initActive.length) {
- this.$slides.eq(0).addClass('is-active');
- }
- if (!this.options.useMUI) {
- this.$slides.addClass('no-motionui');
- }
- if ($images.length) {
- onImagesLoaded($images, this._prepareForOrbit.bind(this));
- } else {
- this._prepareForOrbit();//hehe
- }
- if (this.options.bullets) {
- this._loadBullets();
- }
- this._events();
- if (this.options.autoPlay && this.$slides.length > 1) {
- this.geoSync();
- }
- if (this.options.accessible) { // allow wrapper to be focusable to enable arrow navigation
- this.$wrapper.attr('tabindex', 0);
- }
- }
- /**
- * Creates a jQuery collection of bullets, if they are being used.
- * @function
- * @private
- */
- _loadBullets() {
- this.$bullets = this.$element.find(`.${this.options.boxOfBullets}`).find('button');
- }
- /**
- * Sets a `timer` object on the orbit, and starts the counter for the next slide.
- * @function
- */
- geoSync() {
- var _this = this;
- this.timer = new Timer(
- this.$element,
- {
- duration: this.options.timerDelay,
- infinite: false
- },
- function() {
- _this.changeSlide(true);
- });
- this.timer.start();
- }
- /**
- * Sets wrapper and slide heights for the orbit.
- * @function
- * @private
- */
- _prepareForOrbit() {
- var _this = this;
- this._setWrapperHeight();
- }
- /**
- * Calulates the height of each slide in the collection, and uses the tallest one for the wrapper height.
- * @function
- * @private
- * @param {Function} cb - a callback function to fire when complete.
- */
- _setWrapperHeight(cb) {//rewrite this to `for` loop
- var max = 0, temp, counter = 0, _this = this;
- this.$slides.each(function() {
- temp = this.getBoundingClientRect().height;
- $(this).attr('data-slide', counter);
- // hide all slides but the active one
- if (!/mui/g.test($(this)[0].className) && _this.$slides.filter('.is-active')[0] !== _this.$slides.eq(counter)[0]) {
- $(this).css({'display': 'none'});
- }
- max = temp > max ? temp : max;
- counter++;
- });
- if (counter === this.$slides.length) {
- this.$wrapper.css({'height': max}); //only change the wrapper height property once.
- if(cb) {cb(max);} //fire callback with max height dimension.
- }
- }
- /**
- * Sets the max-height of each slide.
- * @function
- * @private
- */
- _setSlideHeight(height) {
- this.$slides.each(function() {
- $(this).css('max-height', height);
- });
- }
- /**
- * Adds event listeners to basically everything within the element.
- * @function
- * @private
- */
- _events() {
- var _this = this;
- //***************************************
- //**Now using custom event - thanks to:**
- //** Yohai Ararat of Toronto **
- //***************************************
- //
- this.$element.off('.resizeme.zf.trigger').on({
- 'resizeme.zf.trigger': this._prepareForOrbit.bind(this)
- })
- if (this.$slides.length > 1) {
- if (this.options.swipe) {
- this.$slides.off('swipeleft.zf.orbit swiperight.zf.orbit')
- .on('swipeleft.zf.orbit', function(e){
- e.preventDefault();
- _this.changeSlide(true);
- }).on('swiperight.zf.orbit', function(e){
- e.preventDefault();
- _this.changeSlide(false);
- });
- }
- //***************************************
- if (this.options.autoPlay) {
- this.$slides.on('click.zf.orbit', function() {
- _this.$element.data('clickedOn', _this.$element.data('clickedOn') ? false : true);
- _this.timer[_this.$element.data('clickedOn') ? 'pause' : 'start']();
- });
- if (this.options.pauseOnHover) {
- this.$element.on('mouseenter.zf.orbit', function() {
- _this.timer.pause();
- }).on('mouseleave.zf.orbit', function() {
- if (!_this.$element.data('clickedOn')) {
- _this.timer.start();
- }
- });
- }
- }
- if (this.options.navButtons) {
- var $controls = this.$element.find(`.${this.options.nextClass}, .${this.options.prevClass}`);
- $controls.attr('tabindex', 0)
- //also need to handle enter/return and spacebar key presses
- .on('click.zf.orbit touchend.zf.orbit', function(e){
- e.preventDefault();
- _this.changeSlide($(this).hasClass(_this.options.nextClass));
- });
- }
- if (this.options.bullets) {
- this.$bullets.on('click.zf.orbit touchend.zf.orbit', function() {
- if (/is-active/g.test(this.className)) { return false; }//if this is active, kick out of function.
- var idx = $(this).data('slide'),
- ltr = idx > _this.$slides.filter('.is-active').data('slide'),
- $slide = _this.$slides.eq(idx);
- _this.changeSlide(ltr, $slide, idx);
- });
- }
- if (this.options.accessible) {
- this.$wrapper.add(this.$bullets).on('keydown.zf.orbit', function(e) {
- // handle keyboard event with keyboard util
- Keyboard.handleKey(e, 'Orbit', {
- next: function() {
- _this.changeSlide(true);
- },
- previous: function() {
- _this.changeSlide(false);
- },
- handled: function() { // if bullet is focused, make sure focus moves
- if ($(e.target).is(_this.$bullets)) {
- _this.$bullets.filter('.is-active').focus();
- }
- }
- });
- });
- }
- }
- }
- /**
- * Resets Orbit so it can be reinitialized
- */
- _reset() {
- // Don't do anything if there are no slides (first run)
- if (typeof this.$slides == 'undefined') {
- return;
- }
- if (this.$slides.length > 1) {
- // Remove old events
- this.$element.off('.zf.orbit').find('*').off('.zf.orbit')
- // Restart timer if autoPlay is enabled
- if (this.options.autoPlay) {
- this.timer.restart();
- }
- // Reset all sliddes
- this.$slides.each(function(el) {
- $(el).removeClass('is-active is-active is-in')
- .removeAttr('aria-live')
- .hide();
- });
- // Show the first slide
- this.$slides.first().addClass('is-active').show();
- // Triggers when the slide has finished animating
- this.$element.trigger('slidechange.zf.orbit', [this.$slides.first()]);
- // Select first bullet if bullets are present
- if (this.options.bullets) {
- this._updateBullets(0);
- }
- }
- }
- /**
- * Changes the current slide to a new one.
- * @function
- * @param {Boolean} isLTR - if true the slide moves from right to left, if false the slide moves from left to right.
- * @param {jQuery} chosenSlide - the jQuery element of the slide to show next, if one is selected.
- * @param {Number} idx - the index of the new slide in its collection, if one chosen.
- * @fires Orbit#slidechange
- */
- changeSlide(isLTR, chosenSlide, idx) {
- if (!this.$slides) {return; } // Don't freak out if we're in the middle of cleanup
- var $curSlide = this.$slides.filter('.is-active').eq(0);
- if (/mui/g.test($curSlide[0].className)) { return false; } //if the slide is currently animating, kick out of the function
- var $firstSlide = this.$slides.first(),
- $lastSlide = this.$slides.last(),
- dirIn = isLTR ? 'Right' : 'Left',
- dirOut = isLTR ? 'Left' : 'Right',
- _this = this,
- $newSlide;
- if (!chosenSlide) { //most of the time, this will be auto played or clicked from the navButtons.
- $newSlide = isLTR ? //if wrapping enabled, check to see if there is a `next` or `prev` sibling, if not, select the first or last slide to fill in. if wrapping not enabled, attempt to select `next` or `prev`, if there's nothing there, the function will kick out on next step. CRAZY NESTED TERNARIES!!!!!
- (this.options.infiniteWrap ? $curSlide.next(`.${this.options.slideClass}`).length ? $curSlide.next(`.${this.options.slideClass}`) : $firstSlide : $curSlide.next(`.${this.options.slideClass}`))//pick next slide if moving left to right
- :
- (this.options.infiniteWrap ? $curSlide.prev(`.${this.options.slideClass}`).length ? $curSlide.prev(`.${this.options.slideClass}`) : $lastSlide : $curSlide.prev(`.${this.options.slideClass}`));//pick prev slide if moving right to left
- } else {
- $newSlide = chosenSlide;
- }
- if ($newSlide.length) {
- /**
- * Triggers before the next slide starts animating in and only if a next slide has been found.
- * @event Orbit#beforeslidechange
- */
- this.$element.trigger('beforeslidechange.zf.orbit', [$curSlide, $newSlide]);
- if (this.options.bullets) {
- idx = idx || this.$slides.index($newSlide); //grab index to update bullets
- this._updateBullets(idx);
- }
- if (this.options.useMUI && !this.$element.is(':hidden')) {
- Motion.animateIn(
- $newSlide.addClass('is-active'),
- this.options[`animInFrom${dirIn}`],
- function(){
- $newSlide.css({'display': 'block'}).attr('aria-live', 'polite');
- });
- Motion.animateOut(
- $curSlide.removeClass('is-active'),
- this.options[`animOutTo${dirOut}`],
- function(){
- $curSlide.removeAttr('aria-live');
- if(_this.options.autoPlay && !_this.timer.isPaused){
- _this.timer.restart();
- }
- //do stuff?
- });
- } else {
- $curSlide.removeClass('is-active is-in').removeAttr('aria-live').hide();
- $newSlide.addClass('is-active is-in').attr('aria-live', 'polite').show();
- if (this.options.autoPlay && !this.timer.isPaused) {
- this.timer.restart();
- }
- }
- /**
- * Triggers when the slide has finished animating in.
- * @event Orbit#slidechange
- */
- this.$element.trigger('slidechange.zf.orbit', [$newSlide]);
- }
- }
- /**
- * Updates the active state of the bullets, if displayed.
- * @function
- * @private
- * @param {Number} idx - the index of the current slide.
- */
- _updateBullets(idx) {
- var $oldBullet = this.$element.find(`.${this.options.boxOfBullets}`)
- .find('.is-active').removeClass('is-active').blur(),
- span = $oldBullet.find('span:last').detach(),
- $newBullet = this.$bullets.eq(idx).addClass('is-active').append(span);
- }
- /**
- * Destroys the carousel and hides the element.
- * @function
- */
- _destroy() {
- this.$element.off('.zf.orbit').find('*').off('.zf.orbit').end().hide();
- }
- }
- Orbit.defaults = {
- /**
- * Tells the JS to look for and loadBullets.
- * @option
- * @type {boolean}
- * @default true
- */
- bullets: true,
- /**
- * Tells the JS to apply event listeners to nav buttons
- * @option
- * @type {boolean}
- * @default true
- */
- navButtons: true,
- /**
- * motion-ui animation class to apply
- * @option
- * @type {string}
- * @default 'slide-in-right'
- */
- animInFromRight: 'slide-in-right',
- /**
- * motion-ui animation class to apply
- * @option
- * @type {string}
- * @default 'slide-out-right'
- */
- animOutToRight: 'slide-out-right',
- /**
- * motion-ui animation class to apply
- * @option
- * @type {string}
- * @default 'slide-in-left'
- *
- */
- animInFromLeft: 'slide-in-left',
- /**
- * motion-ui animation class to apply
- * @option
- * @type {string}
- * @default 'slide-out-left'
- */
- animOutToLeft: 'slide-out-left',
- /**
- * Allows Orbit to automatically animate on page load.
- * @option
- * @type {boolean}
- * @default true
- */
- autoPlay: true,
- /**
- * Amount of time, in ms, between slide transitions
- * @option
- * @type {number}
- * @default 5000
- */
- timerDelay: 5000,
- /**
- * Allows Orbit to infinitely loop through the slides
- * @option
- * @type {boolean}
- * @default true
- */
- infiniteWrap: true,
- /**
- * Allows the Orbit slides to bind to swipe events for mobile, requires an additional util library
- * @option
- * @type {boolean}
- * @default true
- */
- swipe: true,
- /**
- * Allows the timing function to pause animation on hover.
- * @option
- * @type {boolean}
- * @default true
- */
- pauseOnHover: true,
- /**
- * Allows Orbit to bind keyboard events to the slider, to animate frames with arrow keys
- * @option
- * @type {boolean}
- * @default true
- */
- accessible: true,
- /**
- * Class applied to the container of Orbit
- * @option
- * @type {string}
- * @default 'orbit-container'
- */
- containerClass: 'orbit-container',
- /**
- * Class applied to individual slides.
- * @option
- * @type {string}
- * @default 'orbit-slide'
- */
- slideClass: 'orbit-slide',
- /**
- * Class applied to the bullet container. You're welcome.
- * @option
- * @type {string}
- * @default 'orbit-bullets'
- */
- boxOfBullets: 'orbit-bullets',
- /**
- * Class applied to the `next` navigation button.
- * @option
- * @type {string}
- * @default 'orbit-next'
- */
- nextClass: 'orbit-next',
- /**
- * Class applied to the `previous` navigation button.
- * @option
- * @type {string}
- * @default 'orbit-previous'
- */
- prevClass: 'orbit-previous',
- /**
- * Boolean to flag the js to use motion ui classes or not. Default to true for backwards compatibility.
- * @option
- * @type {boolean}
- * @default true
- */
- useMUI: true
- };
- export {Orbit};
|