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

483 lines
15 KiB
JavaScript
Raw Normal View History

2018-11-13 07:41:12 +01:00
/*!
2019-02-13 17:01:40 +01:00
* Bootstrap scrollspy.js v4.3.1 (https://getbootstrap.com/)
2019-01-04 17:29:45 +01:00
* Copyright 2011-2019 The Bootstrap Authors (https://github.com/twbs/bootstrap/graphs/contributors)
2018-11-13 07:41:12 +01:00
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
*/
2018-07-24 02:51:14 +02:00
(function (global, factory) {
2019-10-08 08:39:10 +02:00
typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory(require('./dom/data.js'), require('./dom/event-handler.js'), require('./dom/manipulator.js'), require('./dom/selector-engine.js')) :
typeof define === 'function' && define.amd ? define(['./dom/data.js', './dom/event-handler.js', './dom/manipulator.js', './dom/selector-engine.js'], factory) :
2019-03-01 17:31:34 +01:00
(global = global || self, global.ScrollSpy = factory(global.Data, global.EventHandler, global.Manipulator, global.SelectorEngine));
2019-11-08 09:11:23 +01:00
}(this, (function (Data, EventHandler, Manipulator, SelectorEngine) { 'use strict';
2018-07-24 02:51:14 +02:00
2019-03-01 17:31:34 +01:00
Data = Data && Data.hasOwnProperty('default') ? Data['default'] : Data;
EventHandler = EventHandler && EventHandler.hasOwnProperty('default') ? EventHandler['default'] : EventHandler;
Manipulator = Manipulator && Manipulator.hasOwnProperty('default') ? Manipulator['default'] : Manipulator;
SelectorEngine = SelectorEngine && SelectorEngine.hasOwnProperty('default') ? SelectorEngine['default'] : SelectorEngine;
2018-07-24 02:51:14 +02:00
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 _defineProperty(obj, key, value) {
if (key in obj) {
Object.defineProperty(obj, key, {
value: value,
enumerable: true,
configurable: true,
writable: true
});
} else {
obj[key] = value;
}
return obj;
}
function ownKeys(object, enumerableOnly) {
var keys = Object.keys(object);
if (Object.getOwnPropertySymbols) {
var symbols = Object.getOwnPropertySymbols(object);
if (enumerableOnly) symbols = symbols.filter(function (sym) {
return Object.getOwnPropertyDescriptor(object, sym).enumerable;
});
keys.push.apply(keys, symbols);
}
return keys;
}
function _objectSpread2(target) {
2018-07-24 02:51:14 +02:00
for (var i = 1; i < arguments.length; i++) {
var source = arguments[i] != null ? arguments[i] : {};
2018-03-31 22:59:37 +02:00
if (i % 2) {
ownKeys(source, true).forEach(function (key) {
_defineProperty(target, key, source[key]);
});
} else if (Object.getOwnPropertyDescriptors) {
Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
} else {
ownKeys(source).forEach(function (key) {
Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
});
2018-07-24 02:51:14 +02:00
}
}
2017-09-06 06:05:12 +02:00
2018-07-24 02:51:14 +02:00
return target;
}
2015-05-11 21:05:35 +02:00
2019-03-01 17:31:34 +01:00
/**
* --------------------------------------------------------------------------
* Bootstrap (v4.3.1): util/index.js
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
* --------------------------------------------------------------------------
*/
var MAX_UID = 1000000;
var toType = function toType(obj) {
return {}.toString.call(obj).match(/\s([a-z]+)/i)[1].toLowerCase();
};
/**
* --------------------------------------------------------------------------
* Public Util Api
* --------------------------------------------------------------------------
*/
var getUID = function getUID(prefix) {
do {
prefix += ~~(Math.random() * MAX_UID); // "~~" acts like a faster Math.floor() here
} while (document.getElementById(prefix));
return prefix;
};
2019-08-27 15:03:21 +02:00
var getSelector = function getSelector(element) {
2019-03-01 17:31:34 +01:00
var selector = element.getAttribute('data-target');
if (!selector || selector === '#') {
var hrefAttr = element.getAttribute('href');
2019-08-27 15:03:21 +02:00
selector = hrefAttr && hrefAttr !== '#' ? hrefAttr.trim() : null;
2019-03-01 17:31:34 +01:00
}
2019-08-27 15:03:21 +02:00
return selector;
};
var getSelectorFromElement = function getSelectorFromElement(element) {
var selector = getSelector(element);
if (selector) {
2019-03-01 17:31:34 +01:00
return document.querySelector(selector) ? selector : null;
}
2019-08-27 15:03:21 +02:00
return null;
2019-03-01 17:31:34 +01:00
};
var isElement = function isElement(obj) {
return (obj[0] || obj).nodeType;
};
var typeCheckConfig = function typeCheckConfig(componentName, config, configTypes) {
Object.keys(configTypes).forEach(function (property) {
var expectedTypes = configTypes[property];
var value = config[property];
var valueType = value && isElement(value) ? 'element' : toType(value);
if (!new RegExp(expectedTypes).test(valueType)) {
throw new Error(componentName.toUpperCase() + ": " + ("Option \"" + property + "\" provided type \"" + valueType + "\" ") + ("but expected type \"" + expectedTypes + "\"."));
}
});
};
var makeArray = function makeArray(nodeList) {
if (!nodeList) {
return [];
}
return [].slice.call(nodeList);
};
2019-08-27 15:03:21 +02:00
var getjQuery = function getjQuery() {
var _window = window,
jQuery = _window.jQuery;
if (jQuery && !document.body.hasAttribute('data-no-jquery')) {
return jQuery;
}
return null;
};
2018-11-13 07:41:12 +01:00
/**
* ------------------------------------------------------------------------
* Constants
* ------------------------------------------------------------------------
*/
var NAME = 'scrollspy';
2019-02-13 17:01:40 +01:00
var VERSION = '4.3.1';
2018-11-13 07:41:12 +01:00
var DATA_KEY = 'bs.scrollspy';
var EVENT_KEY = "." + DATA_KEY;
var DATA_API_KEY = '.data-api';
var Default = {
offset: 10,
method: 'auto',
target: ''
};
var DefaultType = {
offset: 'number',
method: 'string',
target: '(string|element)'
};
var Event = {
ACTIVATE: "activate" + EVENT_KEY,
SCROLL: "scroll" + EVENT_KEY,
LOAD_DATA_API: "load" + EVENT_KEY + DATA_API_KEY
};
var ClassName = {
DROPDOWN_ITEM: 'dropdown-item',
ACTIVE: 'active'
};
var Selector = {
DATA_SPY: '[data-spy="scroll"]',
NAV_LIST_GROUP: '.nav, .list-group',
NAV_LINKS: '.nav-link',
NAV_ITEMS: '.nav-item',
LIST_ITEMS: '.list-group-item',
DROPDOWN: '.dropdown',
DROPDOWN_TOGGLE: '.dropdown-toggle'
};
var OffsetMethod = {
OFFSET: 'offset',
POSITION: 'position'
};
2019-10-08 08:39:10 +02:00
/**
* ------------------------------------------------------------------------
* Class Definition
* ------------------------------------------------------------------------
*/
2018-11-13 07:41:12 +01:00
var ScrollSpy =
/*#__PURE__*/
function () {
function ScrollSpy(element, config) {
var _this = this;
this._element = element;
this._scrollElement = element.tagName === 'BODY' ? window : element;
this._config = this._getConfig(config);
2019-03-11 16:13:30 +01:00
this._selector = this._config.target + " " + Selector.NAV_LINKS + "," + (this._config.target + " " + Selector.LIST_ITEMS + ",") + (this._config.target + " ." + ClassName.DROPDOWN_ITEM);
2018-11-13 07:41:12 +01:00
this._offsets = [];
this._targets = [];
this._activeTarget = null;
this._scrollHeight = 0;
2019-03-01 17:31:34 +01:00
EventHandler.on(this._scrollElement, Event.SCROLL, function (event) {
2018-11-13 07:41:12 +01:00
return _this._process(event);
});
this.refresh();
2015-08-13 06:12:03 +02:00
2018-11-13 07:41:12 +01:00
this._process();
2019-03-01 17:31:34 +01:00
Data.setData(element, DATA_KEY, this);
2018-11-13 07:41:12 +01:00
} // Getters
2015-05-11 21:05:35 +02:00
2018-11-13 07:41:12 +01:00
var _proto = ScrollSpy.prototype;
2015-05-11 21:05:35 +02:00
2018-11-13 07:41:12 +01:00
// Public
_proto.refresh = function refresh() {
var _this2 = this;
2017-09-30 23:28:03 +02:00
2018-11-13 07:41:12 +01:00
var autoMethod = this._scrollElement === this._scrollElement.window ? OffsetMethod.OFFSET : OffsetMethod.POSITION;
var offsetMethod = this._config.method === 'auto' ? autoMethod : this._config.method;
var offsetBase = offsetMethod === OffsetMethod.POSITION ? this._getScrollTop() : 0;
this._offsets = [];
this._targets = [];
this._scrollHeight = this._getScrollHeight();
2019-03-01 17:31:34 +01:00
var targets = makeArray(SelectorEngine.find(this._selector));
2018-11-13 07:41:12 +01:00
targets.map(function (element) {
var target;
2019-03-01 17:31:34 +01:00
var targetSelector = getSelectorFromElement(element);
2018-07-24 02:51:14 +02:00
2018-11-13 07:41:12 +01:00
if (targetSelector) {
2019-03-01 17:31:34 +01:00
target = SelectorEngine.findOne(targetSelector);
2018-11-13 07:41:12 +01:00
}
2018-11-13 07:41:12 +01:00
if (target) {
var targetBCR = target.getBoundingClientRect();
2015-05-11 21:05:35 +02:00
2018-11-13 07:41:12 +01:00
if (targetBCR.width || targetBCR.height) {
2019-03-01 17:31:34 +01:00
return [Manipulator[offsetMethod](target).top + offsetBase, targetSelector];
2017-09-30 23:28:03 +02:00
}
2018-11-13 07:41:12 +01:00
}
2015-05-11 21:05:35 +02:00
2018-11-13 07:41:12 +01:00
return null;
}).filter(function (item) {
return item;
}).sort(function (a, b) {
return a[0] - b[0];
}).forEach(function (item) {
_this2._offsets.push(item[0]);
2015-05-13 22:43:56 +02:00
2018-11-13 07:41:12 +01:00
_this2._targets.push(item[1]);
});
};
2016-10-10 02:26:51 +02:00
2018-11-13 07:41:12 +01:00
_proto.dispose = function dispose() {
2019-03-01 17:31:34 +01:00
Data.removeData(this._element, DATA_KEY);
EventHandler.off(this._scrollElement, EVENT_KEY);
2018-11-13 07:41:12 +01:00
this._element = null;
this._scrollElement = null;
this._config = null;
this._selector = null;
this._offsets = null;
this._targets = null;
this._activeTarget = null;
this._scrollHeight = null;
2019-01-04 17:29:45 +01:00
} // Private
;
2018-11-13 07:41:12 +01:00
_proto._getConfig = function _getConfig(config) {
config = _objectSpread2({}, Default, {}, typeof config === 'object' && config ? config : {});
2018-11-13 07:41:12 +01:00
if (typeof config.target !== 'string') {
2019-03-01 17:31:34 +01:00
var id = config.target.id;
2018-11-13 07:41:12 +01:00
if (!id) {
2019-03-01 17:31:34 +01:00
id = getUID(NAME);
config.target.id = id;
2018-07-24 02:51:14 +02:00
}
2016-01-09 09:40:51 +01:00
2018-11-13 07:41:12 +01:00
config.target = "#" + id;
}
2016-10-10 02:26:51 +02:00
2019-03-01 17:31:34 +01:00
typeCheckConfig(NAME, config, DefaultType);
2018-11-13 07:41:12 +01:00
return config;
};
2015-05-11 21:05:35 +02:00
2018-11-13 07:41:12 +01:00
_proto._getScrollTop = function _getScrollTop() {
return this._scrollElement === window ? this._scrollElement.pageYOffset : this._scrollElement.scrollTop;
};
2015-05-11 21:05:35 +02:00
2018-11-13 07:41:12 +01:00
_proto._getScrollHeight = function _getScrollHeight() {
return this._scrollElement.scrollHeight || Math.max(document.body.scrollHeight, document.documentElement.scrollHeight);
};
2015-05-11 21:05:35 +02:00
2018-11-13 07:41:12 +01:00
_proto._getOffsetHeight = function _getOffsetHeight() {
return this._scrollElement === window ? window.innerHeight : this._scrollElement.getBoundingClientRect().height;
};
2015-05-11 21:05:35 +02:00
2018-11-13 07:41:12 +01:00
_proto._process = function _process() {
var scrollTop = this._getScrollTop() + this._config.offset;
2015-05-11 21:05:35 +02:00
2018-11-13 07:41:12 +01:00
var scrollHeight = this._getScrollHeight();
2017-09-30 23:28:03 +02:00
2018-11-13 07:41:12 +01:00
var maxScroll = this._config.offset + scrollHeight - this._getOffsetHeight();
2017-09-30 23:28:03 +02:00
2018-11-13 07:41:12 +01:00
if (this._scrollHeight !== scrollHeight) {
this.refresh();
}
2017-09-30 23:28:03 +02:00
2018-11-13 07:41:12 +01:00
if (scrollTop >= maxScroll) {
var target = this._targets[this._targets.length - 1];
2015-05-11 21:05:35 +02:00
2018-11-13 07:41:12 +01:00
if (this._activeTarget !== target) {
this._activate(target);
2018-07-24 02:51:14 +02:00
}
2015-05-11 21:05:35 +02:00
2018-11-13 07:41:12 +01:00
return;
}
2018-07-24 02:51:14 +02:00
2018-11-13 07:41:12 +01:00
if (this._activeTarget && scrollTop < this._offsets[0] && this._offsets[0] > 0) {
this._activeTarget = null;
2017-09-30 23:28:03 +02:00
2018-11-13 07:41:12 +01:00
this._clear();
2018-06-22 07:55:23 +02:00
2018-11-13 07:41:12 +01:00
return;
}
2015-05-11 21:05:35 +02:00
2018-11-13 07:41:12 +01:00
var offsetLength = this._offsets.length;
2018-07-24 02:51:14 +02:00
2018-11-13 07:41:12 +01:00
for (var i = offsetLength; i--;) {
var isActiveTarget = this._activeTarget !== this._targets[i] && scrollTop >= this._offsets[i] && (typeof this._offsets[i + 1] === 'undefined' || scrollTop < this._offsets[i + 1]);
2017-09-30 23:28:03 +02:00
2018-11-13 07:41:12 +01:00
if (isActiveTarget) {
this._activate(this._targets[i]);
}
}
};
2017-09-30 23:28:03 +02:00
2018-11-13 07:41:12 +01:00
_proto._activate = function _activate(target) {
this._activeTarget = target;
2017-09-30 23:28:03 +02:00
2018-11-13 07:41:12 +01:00
this._clear();
2017-09-30 23:28:03 +02:00
2018-11-24 17:22:59 +01:00
var queries = this._selector.split(',').map(function (selector) {
return selector + "[data-target=\"" + target + "\"]," + selector + "[href=\"" + target + "\"]";
2018-11-13 07:41:12 +01:00
});
2018-11-24 17:22:59 +01:00
2019-03-01 17:31:34 +01:00
var link = SelectorEngine.findOne(queries.join(','));
2017-09-30 23:28:03 +02:00
2019-03-01 17:31:34 +01:00
if (link.classList.contains(ClassName.DROPDOWN_ITEM)) {
SelectorEngine.findOne(Selector.DROPDOWN_TOGGLE, SelectorEngine.closest(link, Selector.DROPDOWN)).classList.add(ClassName.ACTIVE);
link.classList.add(ClassName.ACTIVE);
2018-11-13 07:41:12 +01:00
} else {
// Set triggered link as active
2019-03-01 17:31:34 +01:00
link.classList.add(ClassName.ACTIVE);
SelectorEngine.parents(link, Selector.NAV_LIST_GROUP).forEach(function (listGroup) {
// Set triggered links parents as active
// With both <ul> and <nav> markup a parent is the previous sibling of any nav ancestor
SelectorEngine.prev(listGroup, Selector.NAV_LINKS + ", " + Selector.LIST_ITEMS).forEach(function (item) {
return item.classList.add(ClassName.ACTIVE);
}); // Handle special case when .nav-link is inside .nav-item
SelectorEngine.prev(listGroup, Selector.NAV_ITEMS).forEach(function (navItem) {
SelectorEngine.children(navItem, Selector.NAV_LINKS).forEach(function (item) {
return item.classList.add(ClassName.ACTIVE);
});
});
});
2018-11-13 07:41:12 +01:00
}
2016-10-10 02:26:51 +02:00
2019-03-01 17:31:34 +01:00
EventHandler.trigger(this._scrollElement, Event.ACTIVATE, {
2018-11-13 07:41:12 +01:00
relatedTarget: target
});
};
2016-10-10 02:26:51 +02:00
2018-11-13 07:41:12 +01:00
_proto._clear = function _clear() {
2019-03-01 17:31:34 +01:00
makeArray(SelectorEngine.find(this._selector)).filter(function (node) {
2018-11-24 17:22:59 +01:00
return node.classList.contains(ClassName.ACTIVE);
}).forEach(function (node) {
return node.classList.remove(ClassName.ACTIVE);
});
2019-01-04 17:29:45 +01:00
} // Static
;
2017-09-30 23:28:03 +02:00
2019-08-27 15:03:21 +02:00
ScrollSpy.jQueryInterface = function jQueryInterface(config) {
2018-11-13 07:41:12 +01:00
return this.each(function () {
2019-03-01 17:31:34 +01:00
var data = Data.getData(this, DATA_KEY);
2017-09-30 23:28:03 +02:00
2018-11-13 07:41:12 +01:00
var _config = typeof config === 'object' && config;
2017-09-30 23:28:03 +02:00
2018-11-13 07:41:12 +01:00
if (!data) {
data = new ScrollSpy(this, _config);
}
2018-07-24 02:51:14 +02:00
2018-11-13 07:41:12 +01:00
if (typeof config === 'string') {
if (typeof data[config] === 'undefined') {
throw new TypeError("No method named \"" + config + "\"");
2017-09-06 06:05:12 +02:00
}
2017-09-30 23:28:03 +02:00
2018-11-13 07:41:12 +01:00
data[config]();
2017-09-30 23:28:03 +02:00
}
2018-11-13 07:41:12 +01:00
});
};
2017-09-30 23:28:03 +02:00
2019-08-27 15:03:21 +02:00
ScrollSpy.getInstance = function getInstance(element) {
2019-03-01 17:31:34 +01:00
return Data.getData(element, DATA_KEY);
};
2018-11-13 07:41:12 +01:00
_createClass(ScrollSpy, null, [{
key: "VERSION",
get: function get() {
return VERSION;
}
}, {
key: "Default",
get: function get() {
return Default;
}
}]);
2015-05-11 21:05:35 +02:00
2018-11-13 07:41:12 +01:00
return ScrollSpy;
}();
/**
* ------------------------------------------------------------------------
* Data Api implementation
* ------------------------------------------------------------------------
*/
2015-05-11 21:05:35 +02:00
2017-09-30 23:28:03 +02:00
2019-03-01 17:31:34 +01:00
EventHandler.on(window, Event.LOAD_DATA_API, function () {
makeArray(SelectorEngine.find(Selector.DATA_SPY)).forEach(function (spy) {
return new ScrollSpy(spy, Manipulator.getDataAttributes(spy));
});
2018-11-13 07:41:12 +01:00
});
2019-08-27 15:03:21 +02:00
var $ = getjQuery();
2018-11-13 07:41:12 +01:00
/**
* ------------------------------------------------------------------------
* jQuery
* ------------------------------------------------------------------------
*/
2015-05-11 21:05:35 +02:00
/* istanbul ignore if */
2019-08-27 15:03:21 +02:00
if ($) {
var JQUERY_NO_CONFLICT = $.fn[NAME];
$.fn[NAME] = ScrollSpy.jQueryInterface;
$.fn[NAME].Constructor = ScrollSpy;
2017-09-30 23:28:03 +02:00
2019-08-27 15:03:21 +02:00
$.fn[NAME].noConflict = function () {
$.fn[NAME] = JQUERY_NO_CONFLICT;
return ScrollSpy.jQueryInterface;
2019-03-01 17:31:34 +01:00
};
}
2015-05-11 21:05:35 +02:00
return ScrollSpy;
2018-07-24 02:51:14 +02:00
2019-11-08 09:11:23 +01:00
})));
2018-07-24 02:51:14 +02:00
//# sourceMappingURL=scrollspy.js.map