1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191 |
- (function (global, factory) {
- typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
- typeof define === 'function' && define.amd ? define(factory) :
- (global = global || self, global.Shuffle = factory());
- }(this, function () {
- 'use strict';
- function _classCallCheck(instance, Constructor) {
- if (!(instance instanceof Constructor)) {
- throw new TypeError("Cannot call a class as a function");
- }
- }
- function _defineProperties(target, props) {
- for (var i = 0; i < props.length; i++) {
- var descriptor = props[i];
- descriptor.enumerable = descriptor.enumerable || false;
- descriptor.configurable = true;
- if ("value" in descriptor) descriptor.writable = true;
- Object.defineProperty(target, descriptor.key, descriptor);
- }
- }
- function _createClass(Constructor, protoProps, staticProps) {
- if (protoProps) _defineProperties(Constructor.prototype, protoProps);
- if (staticProps) _defineProperties(Constructor, staticProps);
- return Constructor;
- }
- function _inherits(subClass, superClass) {
- if (typeof superClass !== "function" && superClass !== null) {
- throw new TypeError("Super expression must either be null or a function");
- }
- subClass.prototype = Object.create(superClass && superClass.prototype, {
- constructor: {
- value: subClass,
- writable: true,
- configurable: true
- }
- });
- if (superClass) _setPrototypeOf(subClass, superClass);
- }
- function _getPrototypeOf(o) {
- _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) {
- return o.__proto__ || Object.getPrototypeOf(o);
- };
- return _getPrototypeOf(o);
- }
- function _setPrototypeOf(o, p) {
- _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) {
- o.__proto__ = p;
- return o;
- };
- return _setPrototypeOf(o, p);
- }
- function _assertThisInitialized(self) {
- if (self === void 0) {
- throw new ReferenceError("this hasn't been initialised - super() hasn't been called");
- }
- return self;
- }
- function _possibleConstructorReturn(self, call) {
- if (call && (typeof call === "object" || typeof call === "function")) {
- return call;
- }
- return _assertThisInitialized(self);
- }
- function E() {
- // Keep this empty so it's easier to inherit from
- // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)
- }
- E.prototype = {
- on: function (name, callback, ctx) {
- var e = this.e || (this.e = {});
- (e[name] || (e[name] = [])).push({
- fn: callback,
- ctx: ctx
- });
- return this;
- },
- once: function (name, callback, ctx) {
- var self = this;
- function listener() {
- self.off(name, listener);
- callback.apply(ctx, arguments);
- }
- listener._ = callback;
- return this.on(name, listener, ctx);
- },
- emit: function (name) {
- var data = [].slice.call(arguments, 1);
- var evtArr = ((this.e || (this.e = {}))[name] || []).slice();
- var i = 0;
- var len = evtArr.length;
- for (i; i < len; i++) {
- evtArr[i].fn.apply(evtArr[i].ctx, data);
- }
- return this;
- },
- off: function (name, callback) {
- var e = this.e || (this.e = {});
- var evts = e[name];
- var liveEvents = [];
- if (evts && callback) {
- for (var i = 0, len = evts.length; i < len; i++) {
- if (evts[i].fn !== callback && evts[i].fn._ !== callback)
- liveEvents.push(evts[i]);
- }
- }
- // Remove event from queue to prevent memory leak
- // Suggested by https://github.com/lazd
- // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910
- (liveEvents.length)
- ? e[name] = liveEvents
- : delete e[name];
- return this;
- }
- };
- var tinyEmitter = E;
- var TinyEmitter = E;
- tinyEmitter.TinyEmitter = TinyEmitter;
- var proto = typeof Element !== 'undefined' ? Element.prototype : {};
- var vendor = proto.matches
- || proto.matchesSelector
- || proto.webkitMatchesSelector
- || proto.mozMatchesSelector
- || proto.msMatchesSelector
- || proto.oMatchesSelector;
- var matchesSelector = match;
- /**
- * Match `el` to `selector`.
- *
- * @param {Element} el
- * @param {String} selector
- * @return {Boolean}
- * @api public
- */
- function match(el, selector) {
- if (!el || el.nodeType !== 1) return false;
- if (vendor) return vendor.call(el, selector);
- var nodes = el.parentNode.querySelectorAll(selector);
- for (var i = 0; i < nodes.length; i++) {
- if (nodes[i] == el) return true;
- }
- return false;
- }
- var throttleit = throttle;
- /**
- * Returns a new function that, when invoked, invokes `func` at most once per `wait` milliseconds.
- *
- * @param {Function} func Function to wrap.
- * @param {Number} wait Number of milliseconds that must elapse between `func` invocations.
- * @return {Function} A new function that wraps the `func` function passed in.
- */
- function throttle(func, wait) {
- var ctx, args, rtn, timeoutID; // caching
- var last = 0;
- return function throttled() {
- ctx = this;
- args = arguments;
- var delta = new Date() - last;
- if (!timeoutID)
- if (delta >= wait) call();
- else timeoutID = setTimeout(call, wait - delta);
- return rtn;
- };
- function call() {
- timeoutID = 0;
- last = +new Date();
- rtn = func.apply(ctx, args);
- ctx = null;
- args = null;
- }
- }
- var arrayParallel = function parallel(fns, context, callback) {
- if (!callback) {
- if (typeof context === 'function') {
- callback = context;
- context = null;
- } else {
- callback = noop;
- }
- }
- var pending = fns && fns.length;
- if (!pending) return callback(null, []);
- var finished = false;
- var results = new Array(pending);
- fns.forEach(context ? function (fn, i) {
- fn.call(context, maybeDone(i));
- } : function (fn, i) {
- fn(maybeDone(i));
- });
- function maybeDone(i) {
- return function (err, result) {
- if (finished) return;
- if (err) {
- callback(err, results);
- finished = true;
- return
- }
- results[i] = result;
- if (!--pending) callback(null, results);
- }
- }
- };
- function noop() { }
- /**
- * Always returns a numeric value, given a value. Logic from jQuery's `isNumeric`.
- * @param {*} value Possibly numeric value.
- * @return {number} `value` or zero if `value` isn't numeric.
- */
- function getNumber(value) {
- return parseFloat(value) || 0;
- }
- var Point =
- /*#__PURE__*/
- function () {
- /**
- * Represents a coordinate pair.
- * @param {number} [x=0] X.
- * @param {number} [y=0] Y.
- */
- function Point(x, y) {
- _classCallCheck(this, Point);
- this.x = getNumber(x);
- this.y = getNumber(y);
- }
- /**
- * Whether two points are equal.
- * @param {Point} a Point A.
- * @param {Point} b Point B.
- * @return {boolean}
- */
- _createClass(Point, null, [{
- key: "equals",
- value: function equals(a, b) {
- return a.x === b.x && a.y === b.y;
- }
- }]);
- return Point;
- }();
- var Rect =
- /*#__PURE__*/
- function () {
- /**
- * Class for representing rectangular regions.
- * https://github.com/google/closure-library/blob/master/closure/goog/math/rect.js
- * @param {number} x Left.
- * @param {number} y Top.
- * @param {number} w Width.
- * @param {number} h Height.
- * @param {number} id Identifier
- * @constructor
- */
- function Rect(x, y, w, h, id) {
- _classCallCheck(this, Rect);
- this.id = id;
- /** @type {number} */
- this.left = x;
- /** @type {number} */
- this.top = y;
- /** @type {number} */
- this.width = w;
- /** @type {number} */
- this.height = h;
- }
- /**
- * Returns whether two rectangles intersect.
- * @param {Rect} a A Rectangle.
- * @param {Rect} b A Rectangle.
- * @return {boolean} Whether a and b intersect.
- */
- _createClass(Rect, null, [{
- key: "intersects",
- value: function intersects(a, b) {
- return a.left < b.left + b.width && b.left < a.left + a.width && a.top < b.top + b.height && b.top < a.top + a.height;
- }
- }]);
- return Rect;
- }();
- var Classes = {
- BASE: 'shuffle',
- SHUFFLE_ITEM: 'shuffle-item',
- VISIBLE: 'shuffle-item--visible',
- HIDDEN: 'shuffle-item--hidden'
- };
- var id = 0;
- var ShuffleItem =
- /*#__PURE__*/
- function () {
- function ShuffleItem(element) {
- _classCallCheck(this, ShuffleItem);
- id += 1;
- this.id = id;
- this.element = element;
- /**
- * Used to separate items for layout and shrink.
- */
- this.isVisible = true;
- /**
- * Used to determine if a transition will happen. By the time the _layout
- * and _shrink methods get the ShuffleItem instances, the `isVisible` value
- * has already been changed by the separation methods, so this property is
- * needed to know if the item was visible/hidden before the shrink/layout.
- */
- this.isHidden = false;
- }
- _createClass(ShuffleItem, [{
- key: "show",
- value: function show() {
- this.isVisible = true;
- this.element.classList.remove(Classes.HIDDEN);
- this.element.classList.add(Classes.VISIBLE);
- this.element.removeAttribute('aria-hidden');
- }
- }, {
- key: "hide",
- value: function hide() {
- this.isVisible = false;
- this.element.classList.remove(Classes.VISIBLE);
- this.element.classList.add(Classes.HIDDEN);
- this.element.setAttribute('aria-hidden', true);
- }
- }, {
- key: "init",
- value: function init() {
- this.addClasses([Classes.SHUFFLE_ITEM, Classes.VISIBLE]);
- this.applyCss(ShuffleItem.Css.INITIAL);
- this.scale = ShuffleItem.Scale.VISIBLE;
- this.point = new Point();
- }
- }, {
- key: "addClasses",
- value: function addClasses(classes) {
- var _this = this;
- classes.forEach(function (className) {
- _this.element.classList.add(className);
- });
- }
- }, {
- key: "removeClasses",
- value: function removeClasses(classes) {
- var _this2 = this;
- classes.forEach(function (className) {
- _this2.element.classList.remove(className);
- });
- }
- }, {
- key: "applyCss",
- value: function applyCss(obj) {
- var _this3 = this;
- Object.keys(obj).forEach(function (key) {
- _this3.element.style[key] = obj[key];
- });
- }
- }, {
- key: "dispose",
- value: function dispose() {
- this.removeClasses([Classes.HIDDEN, Classes.VISIBLE, Classes.SHUFFLE_ITEM]);
- this.element.removeAttribute('style');
- this.element = null;
- }
- }]);
- return ShuffleItem;
- }();
- ShuffleItem.Css = {
- INITIAL: {
- position: 'absolute',
- top: 0,
- left: 0,
- visibility: 'visible',
- willChange: 'transform'
- },
- VISIBLE: {
- before: {
- opacity: 1,
- visibility: 'visible'
- },
- after: {
- transitionDelay: ''
- }
- },
- HIDDEN: {
- before: {
- opacity: 0
- },
- after: {
- visibility: 'hidden',
- transitionDelay: ''
- }
- }
- };
- ShuffleItem.Scale = {
- VISIBLE: 1,
- HIDDEN: 0.001
- };
- var value = null;
- var testComputedSize = (function () {
- if (value !== null) {
- return value;
- }
- var element = document.body || document.documentElement;
- var e = document.createElement('div');
- e.style.cssText = 'width:10px;padding:2px;box-sizing:border-box;';
- element.appendChild(e);
- value = window.getComputedStyle(e, null).width === '10px';
- element.removeChild(e);
- return value;
- });
- /**
- * Retrieve the computed style for an element, parsed as a float.
- * @param {Element} element Element to get style for.
- * @param {string} style Style property.
- * @param {CSSStyleDeclaration} [styles] Optionally include clean styles to
- * use instead of asking for them again.
- * @return {number} The parsed computed value or zero if that fails because IE
- * will return 'auto' when the element doesn't have margins instead of
- * the computed style.
- */
- function getNumberStyle(element, style) {
- var styles = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : window.getComputedStyle(element, null);
- var value = getNumber(styles[style]); // Support IE<=11 and W3C spec.
- if (!testComputedSize() && style === 'width') {
- value += getNumber(styles.paddingLeft) + getNumber(styles.paddingRight) + getNumber(styles.borderLeftWidth) + getNumber(styles.borderRightWidth);
- } else if (!testComputedSize() && style === 'height') {
- value += getNumber(styles.paddingTop) + getNumber(styles.paddingBottom) + getNumber(styles.borderTopWidth) + getNumber(styles.borderBottomWidth);
- }
- return value;
- }
- /**
- * Fisher-Yates shuffle.
- * http://stackoverflow.com/a/962890/373422
- * https://bost.ocks.org/mike/shuffle/
- * @param {Array} array Array to shuffle.
- * @return {Array} Randomly sorted array.
- */
- function randomize(array) {
- var n = array.length;
- while (n) {
- n -= 1;
- var i = Math.floor(Math.random() * (n + 1));
- var temp = array[i];
- array[i] = array[n];
- array[n] = temp;
- }
- return array;
- }
- var defaults = {
- // Use array.reverse() to reverse the results
- reverse: false,
- // Sorting function
- by: null,
- // Custom sort function
- compare: null,
- // If true, this will skip the sorting and return a randomized order in the array
- randomize: false,
- // Determines which property of each item in the array is passed to the
- // sorting method.
- key: 'element'
- };
- /**
- * You can return `undefined` from the `by` function to revert to DOM order.
- * @param {Array<T>} arr Array to sort.
- * @param {SortOptions} options Sorting options.
- * @return {Array<T>}
- */
- function sorter(arr, options) {
- var opts = Object.assign({}, defaults, options);
- var original = Array.from(arr);
- var revert = false;
- if (!arr.length) {
- return [];
- }
- if (opts.randomize) {
- return randomize(arr);
- } // Sort the elements by the opts.by function.
- // If we don't have opts.by, default to DOM order
- if (typeof opts.by === 'function') {
- arr.sort(function (a, b) {
- // Exit early if we already know we want to revert
- if (revert) {
- return 0;
- }
- var valA = opts.by(a[opts.key]);
- var valB = opts.by(b[opts.key]); // If both values are undefined, use the DOM order
- if (valA === undefined && valB === undefined) {
- revert = true;
- return 0;
- }
- if (valA < valB || valA === 'sortFirst' || valB === 'sortLast') {
- return -1;
- }
- if (valA > valB || valA === 'sortLast' || valB === 'sortFirst') {
- return 1;
- }
- return 0;
- });
- } else if (typeof opts.compare === 'function') {
- arr.sort(opts.compare);
- } // Revert to the original array if necessary
- if (revert) {
- return original;
- }
- if (opts.reverse) {
- arr.reverse();
- }
- return arr;
- }
- var transitions = {};
- var eventName = 'transitionend';
- var count = 0;
- function uniqueId() {
- count += 1;
- return eventName + count;
- }
- function cancelTransitionEnd(id) {
- if (transitions[id]) {
- transitions[id].element.removeEventListener(eventName, transitions[id].listener);
- transitions[id] = null;
- return true;
- }
- return false;
- }
- function onTransitionEnd(element, callback) {
- var id = uniqueId();
- var listener = function listener(evt) {
- if (evt.currentTarget === evt.target) {
- cancelTransitionEnd(id);
- callback(evt);
- }
- };
- element.addEventListener(eventName, listener);
- transitions[id] = {
- element: element,
- listener: listener
- };
- return id;
- }
- function arrayMax(array) {
- return Math.max.apply(Math, array); // eslint-disable-line prefer-spread
- }
- function arrayMin(array) {
- return Math.min.apply(Math, array); // eslint-disable-line prefer-spread
- }
- /**
- * Determine the number of columns an items spans.
- * @param {number} itemWidth Width of the item.
- * @param {number} columnWidth Width of the column (includes gutter).
- * @param {number} columns Total number of columns
- * @param {number} threshold A buffer value for the size of the column to fit.
- * @return {number}
- */
- function getColumnSpan(itemWidth, columnWidth, columns, threshold) {
- var columnSpan = itemWidth / columnWidth; // If the difference between the rounded column span number and the
- // calculated column span number is really small, round the number to
- // make it fit.
- if (Math.abs(Math.round(columnSpan) - columnSpan) < threshold) {
- // e.g. columnSpan = 4.0089945390298745
- columnSpan = Math.round(columnSpan);
- } // Ensure the column span is not more than the amount of columns in the whole layout.
- return Math.min(Math.ceil(columnSpan), columns);
- }
- /**
- * Retrieves the column set to use for placement.
- * @param {number} columnSpan The number of columns this current item spans.
- * @param {number} columns The total columns in the grid.
- * @return {Array.<number>} An array of numbers represeting the column set.
- */
- function getAvailablePositions(positions, columnSpan, columns) {
- // The item spans only one column.
- if (columnSpan === 1) {
- return positions;
- } // The item spans more than one column, figure out how many different
- // places it could fit horizontally.
- // The group count is the number of places within the positions this block
- // could fit, ignoring the current positions of items.
- // Imagine a 2 column brick as the second item in a 4 column grid with
- // 10px height each. Find the places it would fit:
- // [20, 10, 10, 0]
- // | | |
- // * * *
- //
- // Then take the places which fit and get the bigger of the two:
- // max([20, 10]), max([10, 10]), max([10, 0]) = [20, 10, 10]
- //
- // Next, find the first smallest number (the short column).
- // [20, 10, 10]
- // |
- // *
- //
- // And that's where it should be placed!
- //
- // Another example where the second column's item extends past the first:
- // [10, 20, 10, 0] => [20, 20, 10] => 10
- var available = []; // For how many possible positions for this item there are.
- for (var i = 0; i <= columns - columnSpan; i++) {
- // Find the bigger value for each place it could fit.
- available.push(arrayMax(positions.slice(i, i + columnSpan)));
- }
- return available;
- }
- /**
- * Find index of short column, the first from the left where this item will go.
- *
- * @param {Array.<number>} positions The array to search for the smallest number.
- * @param {number} buffer Optional buffer which is very useful when the height
- * is a percentage of the width.
- * @return {number} Index of the short column.
- */
- function getShortColumn(positions, buffer) {
- var minPosition = arrayMin(positions);
- for (var i = 0, len = positions.length; i < len; i++) {
- if (positions[i] >= minPosition - buffer && positions[i] <= minPosition + buffer) {
- return i;
- }
- }
- return 0;
- }
- /**
- * Determine the location of the next item, based on its size.
- * @param {Object} itemSize Object with width and height.
- * @param {Array.<number>} positions Positions of the other current items.
- * @param {number} gridSize The column width or row height.
- * @param {number} total The total number of columns or rows.
- * @param {number} threshold Buffer value for the column to fit.
- * @param {number} buffer Vertical buffer for the height of items.
- * @return {Point}
- */
- function getItemPosition(_ref) {
- var itemSize = _ref.itemSize,
- positions = _ref.positions,
- gridSize = _ref.gridSize,
- total = _ref.total,
- threshold = _ref.threshold,
- buffer = _ref.buffer;
- var span = getColumnSpan(itemSize.width, gridSize, total, threshold);
- var setY = getAvailablePositions(positions, span, total);
- var shortColumnIndex = getShortColumn(setY, buffer); // Position the item
- var point = new Point(gridSize * shortColumnIndex, setY[shortColumnIndex]); // Update the columns array with the new values for each column.
- // e.g. before the update the columns could be [250, 0, 0, 0] for an item
- // which spans 2 columns. After it would be [250, itemHeight, itemHeight, 0].
- var setHeight = setY[shortColumnIndex] + itemSize.height;
- for (var i = 0; i < span; i++) {
- positions[shortColumnIndex + i] = setHeight;
- }
- return point;
- }
- /**
- * This method attempts to center items. This method could potentially be slow
- * with a large number of items because it must place items, then check every
- * previous item to ensure there is no overlap.
- * @param {Array.<Rect>} itemRects Item data objects.
- * @param {number} containerWidth Width of the containing element.
- * @return {Array.<Point>}
- */
- function getCenteredPositions(itemRects, containerWidth) {
- var rowMap = {}; // Populate rows by their offset because items could jump between rows like:
- // a c
- // bbb
- itemRects.forEach(function (itemRect) {
- if (rowMap[itemRect.top]) {
- // Push the point to the last row array.
- rowMap[itemRect.top].push(itemRect);
- } else {
- // Start of a new row.
- rowMap[itemRect.top] = [itemRect];
- }
- }); // For each row, find the end of the last item, then calculate
- // the remaining space by dividing it by 2. Then add that
- // offset to the x position of each point.
- var rects = [];
- var rows = [];
- var centeredRows = [];
- Object.keys(rowMap).forEach(function (key) {
- var itemRects = rowMap[key];
- rows.push(itemRects);
- var lastItem = itemRects[itemRects.length - 1];
- var end = lastItem.left + lastItem.width;
- var offset = Math.round((containerWidth - end) / 2);
- var finalRects = itemRects;
- var canMove = false;
- if (offset > 0) {
- var newRects = [];
- canMove = itemRects.every(function (r) {
- var newRect = new Rect(r.left + offset, r.top, r.width, r.height, r.id); // Check all current rects to make sure none overlap.
- var noOverlap = !rects.some(function (r) {
- return Rect.intersects(newRect, r);
- });
- newRects.push(newRect);
- return noOverlap;
- }); // If none of the rectangles overlapped, the whole group can be centered.
- if (canMove) {
- finalRects = newRects;
- }
- } // If the items are not going to be offset, ensure that the original
- // placement for this row will not overlap previous rows (row-spanning
- // elements could be in the way).
- if (!canMove) {
- var intersectingRect;
- var hasOverlap = itemRects.some(function (itemRect) {
- return rects.some(function (r) {
- var intersects = Rect.intersects(itemRect, r);
- if (intersects) {
- intersectingRect = r;
- }
- return intersects;
- });
- }); // If there is any overlap, replace the overlapping row with the original.
- if (hasOverlap) {
- var rowIndex = centeredRows.findIndex(function (items) {
- return items.includes(intersectingRect);
- });
- centeredRows.splice(rowIndex, 1, rows[rowIndex]);
- }
- }
- rects = rects.concat(finalRects);
- centeredRows.push(finalRects);
- }); // Reduce array of arrays to a single array of points.
- // https://stackoverflow.com/a/10865042/373422
- // Then reset sort back to how the items were passed to this method.
- // Remove the wrapper object with index, map to a Point.
- return [].concat.apply([], centeredRows) // eslint-disable-line prefer-spread
- .sort(function (a, b) {
- return a.id - b.id;
- }).map(function (itemRect) {
- return new Point(itemRect.left, itemRect.top);
- });
- }
- /**
- * Hyphenates a javascript style string to a css one. For example:
- * MozBoxSizing -> -moz-box-sizing.
- * @param {string} str The string to hyphenate.
- * @return {string} The hyphenated string.
- */
- function hyphenate(str) {
- return str.replace(/([A-Z])/g, function (str, m1) {
- return "-".concat(m1.toLowerCase());
- });
- }
- function arrayUnique(x) {
- return Array.from(new Set(x));
- } // Used for unique instance variables
- var id$1 = 0;
- var Shuffle =
- /*#__PURE__*/
- function (_TinyEmitter) {
- _inherits(Shuffle, _TinyEmitter);
- /**
- * Categorize, sort, and filter a responsive grid of items.
- *
- * @param {Element} element An element which is the parent container for the grid items.
- * @param {Object} [options=Shuffle.options] Options object.
- * @constructor
- */
- function Shuffle(element) {
- var _this;
- var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
- _classCallCheck(this, Shuffle);
- _this = _possibleConstructorReturn(this, _getPrototypeOf(Shuffle).call(this));
- _this.options = Object.assign({}, Shuffle.options, options); // Allow misspelling of delimiter since that's how it used to be.
- // Remove in v6.
- if (_this.options.delimeter) {
- _this.options.delimiter = _this.options.delimeter;
- }
- _this.lastSort = {};
- _this.group = Shuffle.ALL_ITEMS;
- _this.lastFilter = Shuffle.ALL_ITEMS;
- _this.isEnabled = true;
- _this.isDestroyed = false;
- _this.isInitialized = false;
- _this._transitions = [];
- _this.isTransitioning = false;
- _this._queue = [];
- var el = _this._getElementOption(element);
- if (!el) {
- throw new TypeError('Shuffle needs to be initialized with an element.');
- }
- _this.element = el;
- _this.id = 'shuffle_' + id$1;
- id$1 += 1;
- _this._init();
- _this.isInitialized = true;
- return _this;
- }
- _createClass(Shuffle, [{
- key: "_init",
- value: function _init() {
- this.items = this._getItems();
- this.options.sizer = this._getElementOption(this.options.sizer); // Add class and invalidate styles
- this.element.classList.add(Shuffle.Classes.BASE); // Set initial css for each item
- this._initItems(this.items); // Bind resize events
- this._onResize = this._getResizeFunction();
- window.addEventListener('resize', this._onResize); // If the page has not already emitted the `load` event, call layout on load.
- // This avoids layout issues caused by images and fonts loading after the
- // instance has been initialized.
- if (document.readyState !== 'complete') {
- var layout = this.layout.bind(this);
- window.addEventListener('load', function onLoad() {
- window.removeEventListener('load', onLoad);
- layout();
- });
- } // Get container css all in one request. Causes reflow
- var containerCss = window.getComputedStyle(this.element, null);
- var containerWidth = Shuffle.getSize(this.element).width; // Add styles to the container if it doesn't have them.
- this._validateStyles(containerCss); // We already got the container's width above, no need to cause another
- // reflow getting it again... Calculate the number of columns there will be
- this._setColumns(containerWidth); // Kick off!
- this.filter(this.options.group, this.options.initialSort); // The shuffle items haven't had transitions set on them yet so the user
- // doesn't see the first layout. Set them now that the first layout is done.
- // First, however, a synchronous layout must be caused for the previous
- // styles to be applied without transitions.
- this.element.offsetWidth; // eslint-disable-line no-unused-expressions
- this.setItemTransitions(this.items);
- this.element.style.transition = "height ".concat(this.options.speed, "ms ").concat(this.options.easing);
- }
- /**
- * Returns a throttled and proxied function for the resize handler.
- * @return {function}
- * @private
- */
- }, {
- key: "_getResizeFunction",
- value: function _getResizeFunction() {
- var resizeFunction = this._handleResize.bind(this);
- return this.options.throttle ? this.options.throttle(resizeFunction, this.options.throttleTime) : resizeFunction;
- }
- /**
- * Retrieve an element from an option.
- * @param {string|jQuery|Element} option The option to check.
- * @return {?Element} The plain element or null.
- * @private
- */
- }, {
- key: "_getElementOption",
- value: function _getElementOption(option) {
- // If column width is a string, treat is as a selector and search for the
- // sizer element within the outermost container
- if (typeof option === 'string') {
- return this.element.querySelector(option);
- } // Check for an element
- if (option && option.nodeType && option.nodeType === 1) {
- return option;
- } // Check for jQuery object
- if (option && option.jquery) {
- return option[0];
- }
- return null;
- }
- /**
- * Ensures the shuffle container has the css styles it needs applied to it.
- * @param {Object} styles Key value pairs for position and overflow.
- * @private
- */
- }, {
- key: "_validateStyles",
- value: function _validateStyles(styles) {
- // Position cannot be static.
- if (styles.position === 'static') {
- this.element.style.position = 'relative';
- } // Overflow has to be hidden.
- if (styles.overflow !== 'hidden') {
- this.element.style.overflow = 'hidden';
- }
- }
- /**
- * Filter the elements by a category.
- * @param {string|string[]|function(Element):boolean} [category] Category to
- * filter by. If it's given, the last category will be used to filter the items.
- * @param {Array} [collection] Optionally filter a collection. Defaults to
- * all the items.
- * @return {{visible: ShuffleItem[], hidden: ShuffleItem[]}}
- * @private
- */
- }, {
- key: "_filter",
- value: function _filter() {
- var category = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.lastFilter;
- var collection = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this.items;
- var set = this._getFilteredSets(category, collection); // Individually add/remove hidden/visible classes
- this._toggleFilterClasses(set); // Save the last filter in case elements are appended.
- this.lastFilter = category; // This is saved mainly because providing a filter function (like searching)
- // will overwrite the `lastFilter` property every time its called.
- if (typeof category === 'string') {
- this.group = category;
- }
- return set;
- }
- /**
- * Returns an object containing the visible and hidden elements.
- * @param {string|string[]|function(Element):boolean} category Category or function to filter by.
- * @param {ShuffleItem[]} items A collection of items to filter.
- * @return {{visible: ShuffleItem[], hidden: ShuffleItem[]}}
- * @private
- */
- }, {
- key: "_getFilteredSets",
- value: function _getFilteredSets(category, items) {
- var _this2 = this;
- var visible = [];
- var hidden = []; // category === 'all', add visible class to everything
- if (category === Shuffle.ALL_ITEMS) {
- visible = items; // Loop through each item and use provided function to determine
- // whether to hide it or not.
- } else {
- items.forEach(function (item) {
- if (_this2._doesPassFilter(category, item.element)) {
- visible.push(item);
- } else {
- hidden.push(item);
- }
- });
- }
- return {
- visible: visible,
- hidden: hidden
- };
- }
- /**
- * Test an item to see if it passes a category.
- * @param {string|string[]|function():boolean} category Category or function to filter by.
- * @param {Element} element An element to test.
- * @return {boolean} Whether it passes the category/filter.
- * @private
- */
- }, {
- key: "_doesPassFilter",
- value: function _doesPassFilter(category, element) {
- if (typeof category === 'function') {
- return category.call(element, element, this);
- } // Check each element's data-groups attribute against the given category.
- var attr = element.getAttribute('data-' + Shuffle.FILTER_ATTRIBUTE_KEY);
- var keys = this.options.delimiter ? attr.split(this.options.delimiter) : JSON.parse(attr);
- function testCategory(category) {
- return keys.includes(category);
- }
- if (Array.isArray(category)) {
- if (this.options.filterMode === Shuffle.FilterMode.ANY) {
- return category.some(testCategory);
- }
- return category.every(testCategory);
- }
- return keys.includes(category);
- }
- /**
- * Toggles the visible and hidden class names.
- * @param {{visible, hidden}} Object with visible and hidden arrays.
- * @private
- */
- }, {
- key: "_toggleFilterClasses",
- value: function _toggleFilterClasses(_ref) {
- var visible = _ref.visible,
- hidden = _ref.hidden;
- visible.forEach(function (item) {
- item.show();
- });
- hidden.forEach(function (item) {
- item.hide();
- });
- }
- /**
- * Set the initial css for each item
- * @param {ShuffleItem[]} items Set to initialize.
- * @private
- */
- }, {
- key: "_initItems",
- value: function _initItems(items) {
- items.forEach(function (item) {
- item.init();
- });
- }
- /**
- * Remove element reference and styles.
- * @param {ShuffleItem[]} items Set to dispose.
- * @private
- */
- }, {
- key: "_disposeItems",
- value: function _disposeItems(items) {
- items.forEach(function (item) {
- item.dispose();
- });
- }
- /**
- * Updates the visible item count.
- * @private
- */
- }, {
- key: "_updateItemCount",
- value: function _updateItemCount() {
- this.visibleItems = this._getFilteredItems().length;
- }
- /**
- * Sets css transform transition on a group of elements. This is not executed
- * at the same time as `item.init` so that transitions don't occur upon
- * initialization of a new Shuffle instance.
- * @param {ShuffleItem[]} items Shuffle items to set transitions on.
- * @protected
- */
- }, {
- key: "setItemTransitions",
- value: function setItemTransitions(items) {
- var _this$options = this.options,
- speed = _this$options.speed,
- easing = _this$options.easing;
- var positionProps = this.options.useTransforms ? ['transform'] : ['top', 'left']; // Allow users to transtion other properties if they exist in the `before`
- // css mapping of the shuffle item.
- var cssProps = Object.keys(ShuffleItem.Css.HIDDEN.before).map(function (k) {
- return hyphenate(k);
- });
- var properties = positionProps.concat(cssProps).join();
- items.forEach(function (item) {
- item.element.style.transitionDuration = speed + 'ms';
- item.element.style.transitionTimingFunction = easing;
- item.element.style.transitionProperty = properties;
- });
- }
- }, {
- key: "_getItems",
- value: function _getItems() {
- var _this3 = this;
- return Array.from(this.element.children).filter(function (el) {
- return matchesSelector(el, _this3.options.itemSelector);
- }).map(function (el) {
- return new ShuffleItem(el);
- });
- }
- /**
- * Combine the current items array with a new one and sort it by DOM order.
- * @param {ShuffleItem[]} items Items to track.
- * @return {ShuffleItem[]}
- */
- }, {
- key: "_mergeNewItems",
- value: function _mergeNewItems(items) {
- var children = Array.from(this.element.children);
- return sorter(this.items.concat(items), {
- by: function by(element) {
- return children.indexOf(element);
- }
- });
- }
- }, {
- key: "_getFilteredItems",
- value: function _getFilteredItems() {
- return this.items.filter(function (item) {
- return item.isVisible;
- });
- }
- }, {
- key: "_getConcealedItems",
- value: function _getConcealedItems() {
- return this.items.filter(function (item) {
- return !item.isVisible;
- });
- }
- /**
- * Returns the column size, based on column width and sizer options.
- * @param {number} containerWidth Size of the parent container.
- * @param {number} gutterSize Size of the gutters.
- * @return {number}
- * @private
- */
- }, {
- key: "_getColumnSize",
- value: function _getColumnSize(containerWidth, gutterSize) {
- var size; // If the columnWidth property is a function, then the grid is fluid
- if (typeof this.options.columnWidth === 'function') {
- size = this.options.columnWidth(containerWidth); // columnWidth option isn't a function, are they using a sizing element?
- } else if (this.options.sizer) {
- size = Shuffle.getSize(this.options.sizer).width; // if not, how about the explicitly set option?
- } else if (this.options.columnWidth) {
- size = this.options.columnWidth; // or use the size of the first item
- } else if (this.items.length > 0) {
- size = Shuffle.getSize(this.items[0].element, true).width; // if there's no items, use size of container
- } else {
- size = containerWidth;
- } // Don't let them set a column width of zero.
- if (size === 0) {
- size = containerWidth;
- }
- return size + gutterSize;
- }
- /**
- * Returns the gutter size, based on gutter width and sizer options.
- * @param {number} containerWidth Size of the parent container.
- * @return {number}
- * @private
- */
- }, {
- key: "_getGutterSize",
- value: function _getGutterSize(containerWidth) {
- var size;
- if (typeof this.options.gutterWidth === 'function') {
- size = this.options.gutterWidth(containerWidth);
- } else if (this.options.sizer) {
- size = getNumberStyle(this.options.sizer, 'marginLeft');
- } else {
- size = this.options.gutterWidth;
- }
- return size;
- }
- /**
- * Calculate the number of columns to be used. Gets css if using sizer element.
- * @param {number} [containerWidth] Optionally specify a container width if
- * it's already available.
- */
- }, {
- key: "_setColumns",
- value: function _setColumns() {
- var containerWidth = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : Shuffle.getSize(this.element).width;
- var gutter = this._getGutterSize(containerWidth);
- var columnWidth = this._getColumnSize(containerWidth, gutter);
- var calculatedColumns = (containerWidth + gutter) / columnWidth; // Widths given from getStyles are not precise enough...
- if (Math.abs(Math.round(calculatedColumns) - calculatedColumns) < this.options.columnThreshold) {
- // e.g. calculatedColumns = 11.998876
- calculatedColumns = Math.round(calculatedColumns);
- }
- this.cols = Math.max(Math.floor(calculatedColumns || 0), 1);
- this.containerWidth = containerWidth;
- this.colWidth = columnWidth;
- }
- /**
- * Adjust the height of the grid
- */
- }, {
- key: "_setContainerSize",
- value: function _setContainerSize() {
- this.element.style.height = this._getContainerSize() + 'px';
- }
- /**
- * Based on the column heights, it returns the biggest one.
- * @return {number}
- * @private
- */
- }, {
- key: "_getContainerSize",
- value: function _getContainerSize() {
- return arrayMax(this.positions);
- }
- /**
- * Get the clamped stagger amount.
- * @param {number} index Index of the item to be staggered.
- * @return {number}
- */
- }, {
- key: "_getStaggerAmount",
- value: function _getStaggerAmount(index) {
- return Math.min(index * this.options.staggerAmount, this.options.staggerAmountMax);
- }
- /**
- * Emit an event from this instance.
- * @param {string} name Event name.
- * @param {Object} [data={}] Optional object data.
- */
- }, {
- key: "_dispatch",
- value: function _dispatch(name) {
- var data = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
- if (this.isDestroyed) {
- return;
- }
- data.shuffle = this;
- this.emit(name, data);
- }
- /**
- * Zeros out the y columns array, which is used to determine item placement.
- * @private
- */
- }, {
- key: "_resetCols",
- value: function _resetCols() {
- var i = this.cols;
- this.positions = [];
- while (i) {
- i -= 1;
- this.positions.push(0);
- }
- }
- /**
- * Loops through each item that should be shown and calculates the x, y position.
- * @param {ShuffleItem[]} items Array of items that will be shown/layed
- * out in order in their array.
- */
- }, {
- key: "_layout",
- value: function _layout(items) {
- var _this4 = this;
- var itemPositions = this._getNextPositions(items);
- var count = 0;
- items.forEach(function (item, i) {
- function callback() {
- item.applyCss(ShuffleItem.Css.VISIBLE.after);
- } // If the item will not change its position, do not add it to the render
- // queue. Transitions don't fire when setting a property to the same value.
- if (Point.equals(item.point, itemPositions[i]) && !item.isHidden) {
- item.applyCss(ShuffleItem.Css.VISIBLE.before);
- callback();
- return;
- }
- item.point = itemPositions[i];
- item.scale = ShuffleItem.Scale.VISIBLE;
- item.isHidden = false; // Clone the object so that the `before` object isn't modified when the
- // transition delay is added.
- var styles = _this4.getStylesForTransition(item, ShuffleItem.Css.VISIBLE.before);
- styles.transitionDelay = _this4._getStaggerAmount(count) + 'ms';
- _this4._queue.push({
- item: item,
- styles: styles,
- callback: callback
- });
- count += 1;
- });
- }
- /**
- * Return an array of Point instances representing the future positions of
- * each item.
- * @param {ShuffleItem[]} items Array of sorted shuffle items.
- * @return {Point[]}
- * @private
- */
- }, {
- key: "_getNextPositions",
- value: function _getNextPositions(items) {
- var _this5 = this;
- // If position data is going to be changed, add the item's size to the
- // transformer to allow for calculations.
- if (this.options.isCentered) {
- var itemsData = items.map(function (item, i) {
- var itemSize = Shuffle.getSize(item.element, true);
- var point = _this5._getItemPosition(itemSize);
- return new Rect(point.x, point.y, itemSize.width, itemSize.height, i);
- });
- return this.getTransformedPositions(itemsData, this.containerWidth);
- } // If no transforms are going to happen, simply return an array of the
- // future points of each item.
- return items.map(function (item) {
- return _this5._getItemPosition(Shuffle.getSize(item.element, true));
- });
- }
- /**
- * Determine the location of the next item, based on its size.
- * @param {{width: number, height: number}} itemSize Object with width and height.
- * @return {Point}
- * @private
- */
- }, {
- key: "_getItemPosition",
- value: function _getItemPosition(itemSize) {
- return getItemPosition({
- itemSize: itemSize,
- positions: this.positions,
- gridSize: this.colWidth,
- total: this.cols,
- threshold: this.options.columnThreshold,
- buffer: this.options.buffer
- });
- }
- /**
- * Mutate positions before they're applied.
- * @param {Rect[]} itemRects Item data objects.
- * @param {number} containerWidth Width of the containing element.
- * @return {Point[]}
- * @protected
- */
- }, {
- key: "getTransformedPositions",
- value: function getTransformedPositions(itemRects, containerWidth) {
- return getCenteredPositions(itemRects, containerWidth);
- }
- /**
- * Hides the elements that don't match our filter.
- * @param {ShuffleItem[]} collection Collection to shrink.
- * @private
- */
- }, {
- key: "_shrink",
- value: function _shrink() {
- var _this6 = this;
- var collection = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this._getConcealedItems();
- var count = 0;
- collection.forEach(function (item) {
- function callback() {
- item.applyCss(ShuffleItem.Css.HIDDEN.after);
- } // Continuing would add a transitionend event listener to the element, but
- // that listener would not execute because the transform and opacity would
- // stay the same.
- // The callback is executed here because it is not guaranteed to be called
- // after the transitionend event because the transitionend could be
- // canceled if another animation starts.
- if (item.isHidden) {
- item.applyCss(ShuffleItem.Css.HIDDEN.before);
- callback();
- return;
- }
- item.scale = ShuffleItem.Scale.HIDDEN;
- item.isHidden = true;
- var styles = _this6.getStylesForTransition(item, ShuffleItem.Css.HIDDEN.before);
- styles.transitionDelay = _this6._getStaggerAmount(count) + 'ms';
- _this6._queue.push({
- item: item,
- styles: styles,
- callback: callback
- });
- count += 1;
- });
- }
- /**
- * Resize handler.
- * @private
- */
- }, {
- key: "_handleResize",
- value: function _handleResize() {
- // If shuffle is disabled, destroyed, don't do anything
- if (!this.isEnabled || this.isDestroyed) {
- return;
- }
- this.update();
- }
- /**
- * Returns styles which will be applied to the an item for a transition.
- * @param {ShuffleItem} item Item to get styles for. Should have updated
- * scale and point properties.
- * @param {Object} styleObject Extra styles that will be used in the transition.
- * @return {!Object} Transforms for transitions, left/top for animate.
- * @protected
- */
- }, {
- key: "getStylesForTransition",
- value: function getStylesForTransition(item, styleObject) {
- // Clone the object to avoid mutating the original.
- var styles = Object.assign({}, styleObject);
- if (this.options.useTransforms) {
- var x = this.options.roundTransforms ? Math.round(item.point.x) : item.point.x;
- var y = this.options.roundTransforms ? Math.round(item.point.y) : item.point.y;
- styles.transform = "translate(".concat(x, "px, ").concat(y, "px) scale(").concat(item.scale, ")");
- } else {
- styles.left = item.point.x + 'px';
- styles.top = item.point.y + 'px';
- }
- return styles;
- }
- /**
- * Listen for the transition end on an element and execute the itemCallback
- * when it finishes.
- * @param {Element} element Element to listen on.
- * @param {function} itemCallback Callback for the item.
- * @param {function} done Callback to notify `parallel` that this one is done.
- */
- }, {
- key: "_whenTransitionDone",
- value: function _whenTransitionDone(element, itemCallback, done) {
- var id = onTransitionEnd(element, function (evt) {
- itemCallback();
- done(null, evt);
- });
- this._transitions.push(id);
- }
- /**
- * Return a function which will set CSS styles and call the `done` function
- * when (if) the transition finishes.
- * @param {Object} opts Transition object.
- * @return {function} A function to be called with a `done` function.
- */
- }, {
- key: "_getTransitionFunction",
- value: function _getTransitionFunction(opts) {
- var _this7 = this;
- return function (done) {
- opts.item.applyCss(opts.styles);
- _this7._whenTransitionDone(opts.item.element, opts.callback, done);
- };
- }
- /**
- * Execute the styles gathered in the style queue. This applies styles to elements,
- * triggering transitions.
- * @private
- */
- }, {
- key: "_processQueue",
- value: function _processQueue() {
- if (this.isTransitioning) {
- this._cancelMovement();
- }
- var hasSpeed = this.options.speed > 0;
- var hasQueue = this._queue.length > 0;
- if (hasQueue && hasSpeed && this.isInitialized) {
- this._startTransitions(this._queue);
- } else if (hasQueue) {
- this._styleImmediately(this._queue);
- this._dispatch(Shuffle.EventType.LAYOUT); // A call to layout happened, but none of the newly visible items will
- // change position or the transition duration is zero, which will not trigger
- // the transitionend event.
- } else {
- this._dispatch(Shuffle.EventType.LAYOUT);
- } // Remove everything in the style queue
- this._queue.length = 0;
- }
- /**
- * Wait for each transition to finish, the emit the layout event.
- * @param {Object[]} transitions Array of transition objects.
- */
- }, {
- key: "_startTransitions",
- value: function _startTransitions(transitions) {
- var _this8 = this;
- // Set flag that shuffle is currently in motion.
- this.isTransitioning = true; // Create an array of functions to be called.
- var callbacks = transitions.map(function (obj) {
- return _this8._getTransitionFunction(obj);
- });
- arrayParallel(callbacks, this._movementFinished.bind(this));
- }
- }, {
- key: "_cancelMovement",
- value: function _cancelMovement() {
- // Remove the transition end event for each listener.
- this._transitions.forEach(cancelTransitionEnd); // Reset the array.
- this._transitions.length = 0; // Show it's no longer active.
- this.isTransitioning = false;
- }
- /**
- * Apply styles without a transition.
- * @param {Object[]} objects Array of transition objects.
- * @private
- */
- }, {
- key: "_styleImmediately",
- value: function _styleImmediately(objects) {
- if (objects.length) {
- var elements = objects.map(function (obj) {
- return obj.item.element;
- });
- Shuffle._skipTransitions(elements, function () {
- objects.forEach(function (obj) {
- obj.item.applyCss(obj.styles);
- obj.callback();
- });
- });
- }
- }
- }, {
- key: "_movementFinished",
- value: function _movementFinished() {
- this._transitions.length = 0;
- this.isTransitioning = false;
- this._dispatch(Shuffle.EventType.LAYOUT);
- }
- /**
- * The magic. This is what makes the plugin 'shuffle'
- * @param {string|string[]|function(Element):boolean} [category] Category to filter by.
- * Can be a function, string, or array of strings.
- * @param {SortOptions} [sortOptions] A sort object which can sort the visible set
- */
- }, {
- key: "filter",
- value: function filter(category, sortOptions) {
- if (!this.isEnabled) {
- return;
- }
- if (!category || category && category.length === 0) {
- category = Shuffle.ALL_ITEMS; // eslint-disable-line no-param-reassign
- }
- this._filter(category); // Shrink each hidden item
- this._shrink(); // How many visible elements?
- this._updateItemCount(); // Update transforms on visible elements so they will animate to their new positions.
- this.sort(sortOptions);
- }
- /**
- * Gets the visible elements, sorts them, and passes them to layout.
- * @param {SortOptions} [sortOptions] The options object to pass to `sorter`.
- */
- }, {
- key: "sort",
- value: function sort() {
- var sortOptions = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.lastSort;
- if (!this.isEnabled) {
- return;
- }
- this._resetCols();
- var items = sorter(this._getFilteredItems(), sortOptions);
- this._layout(items); // `_layout` always happens after `_shrink`, so it's safe to process the style
- // queue here with styles from the shrink method.
- this._processQueue(); // Adjust the height of the container.
- this._setContainerSize();
- this.lastSort = sortOptions;
- }
- /**
- * Reposition everything.
- * @param {boolean} [isOnlyLayout=false] If true, column and gutter widths won't be recalculated.
- */
- }, {
- key: "update",
- value: function update() {
- var isOnlyLayout = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
- if (this.isEnabled) {
- if (!isOnlyLayout) {
- // Get updated colCount
- this._setColumns();
- } // Layout items
- this.sort();
- }
- }
- /**
- * Use this instead of `update()` if you don't need the columns and gutters updated
- * Maybe an image inside `shuffle` loaded (and now has a height), which means calculations
- * could be off.
- */
- }, {
- key: "layout",
- value: function layout() {
- this.update(true);
- }
- /**
- * New items have been appended to shuffle. Mix them in with the current
- * filter or sort status.
- * @param {Element[]} newItems Collection of new items.
- */
- }, {
- key: "add",
- value: function add(newItems) {
- var _this9 = this;
- var items = arrayUnique(newItems).map(function (el) {
- return new ShuffleItem(el);
- }); // Add classes and set initial positions.
- this._initItems(items); // Determine which items will go with the current filter.
- this._resetCols();
- var allItems = this._mergeNewItems(items);
- var sortedItems = sorter(allItems, this.lastSort);
- var allSortedItemsSet = this._filter(this.lastFilter, sortedItems);
- var isNewItem = function isNewItem(item) {
- return items.includes(item);
- };
- var applyHiddenState = function applyHiddenState(item) {
- item.scale = ShuffleItem.Scale.HIDDEN;
- item.isHidden = true;
- item.applyCss(ShuffleItem.Css.HIDDEN.before);
- item.applyCss(ShuffleItem.Css.HIDDEN.after);
- }; // Layout all items again so that new items get positions.
- // Synchonously apply positions.
- var itemPositions = this._getNextPositions(allSortedItemsSet.visible);
- allSortedItemsSet.visible.forEach(function (item, i) {
- if (isNewItem(item)) {
- item.point = itemPositions[i];
- applyHiddenState(item);
- item.applyCss(_this9.getStylesForTransition(item, {}));
- }
- });
- allSortedItemsSet.hidden.forEach(function (item) {
- if (isNewItem(item)) {
- applyHiddenState(item);
- }
- }); // Cause layout so that the styles above are applied.
- this.element.offsetWidth; // eslint-disable-line no-unused-expressions
- // Add transition to each item.
- this.setItemTransitions(items); // Update the list of items.
- this.items = this._mergeNewItems(items); // Update layout/visibility of new and old items.
- this.filter(this.lastFilter);
- }
- /**
- * Disables shuffle from updating dimensions and layout on resize
- */
- }, {
- key: "disable",
- value: function disable() {
- this.isEnabled = false;
- }
- /**
- * Enables shuffle again
- * @param {boolean} [isUpdateLayout=true] if undefined, shuffle will update columns and gutters
- */
- }, {
- key: "enable",
- value: function enable() {
- var isUpdateLayout = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : true;
- this.isEnabled = true;
- if (isUpdateLayout) {
- this.update();
- }
- }
- /**
- * Remove 1 or more shuffle items.
- * @param {Element[]} elements An array containing one or more
- * elements in shuffle
- * @return {Shuffle} The shuffle instance.
- */
- }, {
- key: "remove",
- value: function remove(elements) {
- var _this10 = this;
- if (!elements.length) {
- return;
- }
- var collection = arrayUnique(elements);
- var oldItems = collection.map(function (element) {
- return _this10.getItemByElement(element);
- }).filter(function (item) {
- return !!item;
- });
- var handleLayout = function handleLayout() {
- _this10._disposeItems(oldItems); // Remove the collection in the callback
- collection.forEach(function (element) {
- element.parentNode.removeChild(element);
- });
- _this10._dispatch(Shuffle.EventType.REMOVED, {
- collection: collection
- });
- }; // Hide collection first.
- this._toggleFilterClasses({
- visible: [],
- hidden: oldItems
- });
- this._shrink(oldItems);
- this.sort(); // Update the list of items here because `remove` could be called again
- // with an item that is in the process of being removed.
- this.items = this.items.filter(function (item) {
- return !oldItems.includes(item);
- });
- this._updateItemCount();
- this.once(Shuffle.EventType.LAYOUT, handleLayout);
- }
- /**
- * Retrieve a shuffle item by its element.
- * @param {Element} element Element to look for.
- * @return {?ShuffleItem} A shuffle item or undefined if it's not found.
- */
- }, {
- key: "getItemByElement",
- value: function getItemByElement(element) {
- return this.items.find(function (item) {
- return item.element === element;
- });
- }
- /**
- * Dump the elements currently stored and reinitialize all child elements which
- * match the `itemSelector`.
- */
- }, {
- key: "resetItems",
- value: function resetItems() {
- var _this11 = this;
- // Remove refs to current items.
- this._disposeItems(this.items);
- this.isInitialized = false; // Find new items in the DOM.
- this.items = this._getItems(); // Set initial styles on the new items.
- this._initItems(this.items);
- this.once(Shuffle.EventType.LAYOUT, function () {
- // Add transition to each item.
- _this11.setItemTransitions(_this11.items);
- _this11.isInitialized = true;
- }); // Lay out all items.
- this.filter(this.lastFilter);
- }
- /**
- * Destroys shuffle, removes events, styles, and classes
- */
- }, {
- key: "destroy",
- value: function destroy() {
- this._cancelMovement();
- window.removeEventListener('resize', this._onResize); // Reset container styles
- this.element.classList.remove('shuffle');
- this.element.removeAttribute('style'); // Reset individual item styles
- this._disposeItems(this.items);
- this.items.length = 0;
- this._transitions.length = 0; // Null DOM references
- this.options.sizer = null;
- this.element = null; // Set a flag so if a debounced resize has been triggered,
- // it can first check if it is actually isDestroyed and not doing anything
- this.isDestroyed = true;
- this.isEnabled = false;
- }
- /**
- * Returns the outer width of an element, optionally including its margins.
- *
- * There are a few different methods for getting the width of an element, none of
- * which work perfectly for all Shuffle's use cases.
- *
- * 1. getBoundingClientRect() `left` and `right` properties.
- * - Accounts for transform scaled elements, making it useless for Shuffle
- * elements which have shrunk.
- * 2. The `offsetWidth` property.
- * - This value stays the same regardless of the elements transform property,
- * however, it does not return subpixel values.
- * 3. getComputedStyle()
- * - This works great Chrome, Firefox, Safari, but IE<=11 does not include
- * padding and border when box-sizing: border-box is set, requiring a feature
- * test and extra work to add the padding back for IE and other browsers which
- * follow the W3C spec here.
- *
- * @param {Element} element The element.
- * @param {boolean} [includeMargins=false] Whether to include margins.
- * @return {{width: number, height: number}} The width and height.
- */
- }], [{
- key: "getSize",
- value: function getSize(element) {
- var includeMargins = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
- // Store the styles so that they can be used by others without asking for it again.
- var styles = window.getComputedStyle(element, null);
- var width = getNumberStyle(element, 'width', styles);
- var height = getNumberStyle(element, 'height', styles);
- if (includeMargins) {
- var marginLeft = getNumberStyle(element, 'marginLeft', styles);
- var marginRight = getNumberStyle(element, 'marginRight', styles);
- var marginTop = getNumberStyle(element, 'marginTop', styles);
- var marginBottom = getNumberStyle(element, 'marginBottom', styles);
- width += marginLeft + marginRight;
- height += marginTop + marginBottom;
- }
- return {
- width: width,
- height: height
- };
- }
- /**
- * Change a property or execute a function which will not have a transition
- * @param {Element[]} elements DOM elements that won't be transitioned.
- * @param {function} callback A function which will be called while transition
- * is set to 0ms.
- * @private
- */
- }, {
- key: "_skipTransitions",
- value: function _skipTransitions(elements, callback) {
- var zero = '0ms'; // Save current duration and delay.
- var data = elements.map(function (element) {
- var style = element.style;
- var duration = style.transitionDuration;
- var delay = style.transitionDelay; // Set the duration to zero so it happens immediately
- style.transitionDuration = zero;
- style.transitionDelay = zero;
- return {
- duration: duration,
- delay: delay
- };
- });
- callback(); // Cause forced synchronous layout.
- elements[0].offsetWidth; // eslint-disable-line no-unused-expressions
- // Put the duration back
- elements.forEach(function (element, i) {
- element.style.transitionDuration = data[i].duration;
- element.style.transitionDelay = data[i].delay;
- });
- }
- }]);
- return Shuffle;
- }(tinyEmitter);
- Shuffle.ShuffleItem = ShuffleItem;
- Shuffle.ALL_ITEMS = 'all';
- Shuffle.FILTER_ATTRIBUTE_KEY = 'groups';
- /** @enum {string} */
- Shuffle.EventType = {
- LAYOUT: 'shuffle:layout',
- REMOVED: 'shuffle:removed'
- };
- /** @enum {string} */
- Shuffle.Classes = Classes;
- /** @enum {string} */
- Shuffle.FilterMode = {
- ANY: 'any',
- ALL: 'all'
- }; // Overrideable options
- Shuffle.options = {
- // Initial filter group.
- group: Shuffle.ALL_ITEMS,
- // Transition/animation speed (milliseconds).
- speed: 250,
- // CSS easing function to use.
- easing: 'cubic-bezier(0.4, 0.0, 0.2, 1)',
- // e.g. '.picture-item'.
- itemSelector: '*',
- // Element or selector string. Use an element to determine the size of columns
- // and gutters.
- sizer: null,
- // A static number or function that tells the plugin how wide the gutters
- // between columns are (in pixels).
- gutterWidth: 0,
- // A static number or function that returns a number which tells the plugin
- // how wide the columns are (in pixels).
- columnWidth: 0,
- // If your group is not json, and is comma delimeted, you could set delimiter
- // to ','.
- delimiter: null,
- // Useful for percentage based heights when they might not always be exactly
- // the same (in pixels).
- buffer: 0,
- // Reading the width of elements isn't precise enough and can cause columns to
- // jump between values.
- columnThreshold: 0.01,
- // Shuffle can be isInitialized with a sort object. It is the same object
- // given to the sort method.
- initialSort: null,
- // By default, shuffle will throttle resize events. This can be changed or
- // removed.
- throttle: throttleit,
- // How often shuffle can be called on resize (in milliseconds).
- throttleTime: 300,
- // Transition delay offset for each item in milliseconds.
- staggerAmount: 15,
- // Maximum stagger delay in milliseconds.
- staggerAmountMax: 150,
- // Whether to use transforms or absolute positioning.
- useTransforms: true,
- // Affects using an array with filter. e.g. `filter(['one', 'two'])`. With "any",
- // the element passes the test if any of its groups are in the array. With "all",
- // the element only passes if all groups are in the array.
- filterMode: Shuffle.FilterMode.ANY,
- // Attempt to center grid items in each row.
- isCentered: false,
- // Whether to round pixel values used in translate(x, y). This usually avoids
- // blurriness.
- roundTransforms: true
- };
- Shuffle.Point = Point;
- Shuffle.Rect = Rect; // Expose for testing. Hack at your own risk.
- Shuffle.__sorter = sorter;
- Shuffle.__getColumnSpan = getColumnSpan;
- Shuffle.__getAvailablePositions = getAvailablePositions;
- Shuffle.__getShortColumn = getShortColumn;
- Shuffle.__getCenteredPositions = getCenteredPositions;
- return Shuffle;
- }));
- //# sourceMappingURL=shuffle.js.map
|