0
0
mirror of https://github.com/twbs/bootstrap.git synced 2025-01-10 03:46:13 +01:00
Bootstrap/js/src/scrollspy.js

330 lines
9.0 KiB
JavaScript
Raw Normal View History

import $ from 'jquery'
2015-05-11 12:05:35 -07:00
import Util from './util'
/**
* --------------------------------------------------------------------------
2018-04-29 22:28:01 -07:00
* Bootstrap (v4.1.1): scrollspy.js
2015-05-11 12:05:35 -07:00
* Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
* --------------------------------------------------------------------------
*/
const ScrollSpy = (($) => {
2015-05-11 12:05:35 -07:00
/**
* ------------------------------------------------------------------------
* Constants
* ------------------------------------------------------------------------
*/
2015-05-11 12:29:06 -07:00
const NAME = 'scrollspy'
2018-04-29 22:28:01 -07:00
const VERSION = '4.1.1'
2015-05-11 12:29:06 -07:00
const DATA_KEY = 'bs.scrollspy'
2015-05-13 12:48:34 -07:00
const EVENT_KEY = `.${DATA_KEY}`
const DATA_API_KEY = '.data-api'
2015-05-11 12:29:06 -07:00
const JQUERY_NO_CONFLICT = $.fn[NAME]
2015-05-11 12:05:35 -07:00
const Default = {
offset : 10,
2015-05-13 13:43:56 -07:00
method : 'auto',
target : ''
2015-05-11 12:05:35 -07:00
}
2015-05-13 14:46:50 -07:00
const DefaultType = {
offset : 'number',
method : 'string',
target : '(string|element)'
}
2015-05-11 12:05:35 -07:00
const Event = {
2015-05-13 12:48:34 -07:00
ACTIVATE : `activate${EVENT_KEY}`,
SCROLL : `scroll${EVENT_KEY}`,
LOAD_DATA_API : `load${EVENT_KEY}${DATA_API_KEY}`
2015-05-11 12:05:35 -07:00
}
const ClassName = {
DROPDOWN_ITEM : 'dropdown-item',
2015-05-11 12:05:35 -07:00
DROPDOWN_MENU : 'dropdown-menu',
ACTIVE : 'active'
}
const Selector = {
DATA_SPY : '[data-spy="scroll"]',
ACTIVE : '.active',
NAV_LIST_GROUP : '.nav, .list-group',
NAV_LINKS : '.nav-link',
NAV_ITEMS : '.nav-item',
LIST_ITEMS : '.list-group-item',
DROPDOWN : '.dropdown',
DROPDOWN_ITEMS : '.dropdown-item',
DROPDOWN_TOGGLE : '.dropdown-toggle'
2015-05-11 12:05:35 -07:00
}
const OffsetMethod = {
OFFSET : 'offset',
POSITION : 'position'
}
2015-05-11 12:05:35 -07:00
/**
* ------------------------------------------------------------------------
* Class Definition
* ------------------------------------------------------------------------
*/
class ScrollSpy {
constructor(element, config) {
2015-05-13 12:48:34 -07:00
this._element = element
2015-05-11 12:05:35 -07:00
this._scrollElement = element.tagName === 'BODY' ? window : element
2015-05-13 13:43:56 -07:00
this._config = this._getConfig(config)
2017-12-16 14:00:38 +02:00
this._selector = `${this._config.target} ${Selector.NAV_LINKS},` +
`${this._config.target} ${Selector.LIST_ITEMS},` +
`${this._config.target} ${Selector.DROPDOWN_ITEMS}`
2015-05-11 12:05:35 -07:00
this._offsets = []
this._targets = []
this._activeTarget = null
this._scrollHeight = 0
$(this._scrollElement).on(Event.SCROLL, (event) => this._process(event))
2015-05-11 12:05:35 -07:00
this.refresh()
this._process()
}
2017-12-16 14:00:38 +02:00
// Getters
2015-05-11 12:05:35 -07:00
static get VERSION() {
return VERSION
}
static get Default() {
return Default
}
2017-12-16 14:00:38 +02:00
// Public
2015-05-11 12:05:35 -07:00
refresh() {
2017-12-16 14:00:38 +02:00
const autoMethod = this._scrollElement === this._scrollElement.window
? OffsetMethod.OFFSET : OffsetMethod.POSITION
2017-12-16 14:00:38 +02:00
const offsetMethod = this._config.method === 'auto'
? autoMethod : this._config.method
2015-05-11 12:05:35 -07:00
2017-12-16 14:00:38 +02:00
const offsetBase = offsetMethod === OffsetMethod.POSITION
? this._getScrollTop() : 0
2015-05-11 12:05:35 -07:00
this._offsets = []
this._targets = []
this._scrollHeight = this._getScrollHeight()
const targets = $.makeArray($(this._selector))
2015-05-11 12:05:35 -07:00
targets
.map((element) => {
let target
const targetSelector = Util.getSelectorFromElement(element)
2015-05-11 12:05:35 -07:00
if (targetSelector) {
target = $(targetSelector)[0]
}
if (target) {
const targetBCR = target.getBoundingClientRect()
if (targetBCR.width || targetBCR.height) {
2017-12-16 14:00:38 +02:00
// TODO (fat): remove sketch reliance on jQuery position/offset
return [
$(target)[offsetMethod]().top + offsetBase,
targetSelector
]
}
2015-05-11 12:05:35 -07:00
}
return null
2015-05-11 12:05:35 -07:00
})
2017-12-16 14:00:38 +02:00
.filter((item) => item)
.sort((a, b) => a[0] - b[0])
2015-05-11 12:05:35 -07:00
.forEach((item) => {
this._offsets.push(item[0])
this._targets.push(item[1])
})
}
2015-05-13 12:48:34 -07:00
dispose() {
$.removeData(this._element, DATA_KEY)
$(this._scrollElement).off(EVENT_KEY)
this._element = null
this._scrollElement = null
this._config = null
this._selector = null
this._offsets = null
this._targets = null
this._activeTarget = null
this._scrollHeight = null
}
2017-12-16 14:00:38 +02:00
// Private
2015-05-11 12:05:35 -07:00
2015-05-13 13:43:56 -07:00
_getConfig(config) {
config = {
...Default,
...typeof config === 'object' && config ? config : {}
}
2015-05-13 13:43:56 -07:00
if (typeof config.target !== 'string') {
let id = $(config.target).attr('id')
if (!id) {
id = Util.getUID(NAME)
$(config.target).attr('id', id)
}
config.target = `#${id}`
}
2015-05-13 14:46:50 -07:00
Util.typeCheckConfig(NAME, config, DefaultType)
2015-05-13 13:43:56 -07:00
return config
}
2015-05-11 12:05:35 -07:00
_getScrollTop() {
2017-12-16 14:00:38 +02:00
return this._scrollElement === window
? this._scrollElement.pageYOffset : this._scrollElement.scrollTop
2015-05-11 12:05:35 -07:00
}
_getScrollHeight() {
return this._scrollElement.scrollHeight || Math.max(
document.body.scrollHeight,
document.documentElement.scrollHeight
)
}
_getOffsetHeight() {
2017-12-16 14:00:38 +02:00
return this._scrollElement === window
? window.innerHeight : this._scrollElement.getBoundingClientRect().height
}
2015-05-11 12:05:35 -07:00
_process() {
const scrollTop = this._getScrollTop() + this._config.offset
const scrollHeight = this._getScrollHeight()
2017-12-16 14:00:38 +02:00
const maxScroll = this._config.offset +
scrollHeight -
this._getOffsetHeight()
2015-05-11 12:05:35 -07:00
if (this._scrollHeight !== scrollHeight) {
this.refresh()
}
if (scrollTop >= maxScroll) {
const target = this._targets[this._targets.length - 1]
2015-05-11 12:05:35 -07:00
if (this._activeTarget !== target) {
this._activate(target)
}
return
2015-05-11 12:05:35 -07:00
}
if (this._activeTarget && scrollTop < this._offsets[0] && this._offsets[0] > 0) {
2015-05-11 12:05:35 -07:00
this._activeTarget = null
this._clear()
return
}
for (let i = this._offsets.length; i--;) {
2017-12-16 14:00:38 +02:00
const isActiveTarget = this._activeTarget !== this._targets[i] &&
scrollTop >= this._offsets[i] &&
(typeof this._offsets[i + 1] === 'undefined' ||
2015-05-11 12:05:35 -07:00
scrollTop < this._offsets[i + 1])
if (isActiveTarget) {
this._activate(this._targets[i])
}
}
}
_activate(target) {
this._activeTarget = target
this._clear()
2015-08-18 20:33:57 -07:00
let queries = this._selector.split(',')
2017-07-27 13:39:55 +03:00
// eslint-disable-next-line arrow-body-style
2017-12-16 14:00:38 +02:00
queries = queries.map((selector) => {
2015-08-18 20:33:57 -07:00
return `${selector}[data-target="${target}"],` +
`${selector}[href="${target}"]`
})
2015-05-11 12:05:35 -07:00
const $link = $(queries.join(','))
2015-05-11 12:05:35 -07:00
2015-08-18 20:33:57 -07:00
if ($link.hasClass(ClassName.DROPDOWN_ITEM)) {
$link.closest(Selector.DROPDOWN).find(Selector.DROPDOWN_TOGGLE).addClass(ClassName.ACTIVE)
$link.addClass(ClassName.ACTIVE)
} else {
// Set triggered link as active
$link.addClass(ClassName.ACTIVE)
// Set triggered links parents as active
// With both <ul> and <nav> markup a parent is the previous sibling of any nav ancestor
$link.parents(Selector.NAV_LIST_GROUP).prev(`${Selector.NAV_LINKS}, ${Selector.LIST_ITEMS}`).addClass(ClassName.ACTIVE)
// Handle special case when .nav-link is inside .nav-item
$link.parents(Selector.NAV_LIST_GROUP).prev(Selector.NAV_ITEMS).children(Selector.NAV_LINKS).addClass(ClassName.ACTIVE)
2015-05-11 12:05:35 -07:00
}
$(this._scrollElement).trigger(Event.ACTIVATE, {
relatedTarget: target
})
}
_clear() {
$(this._selector).filter(Selector.ACTIVE).removeClass(ClassName.ACTIVE)
2015-05-11 12:05:35 -07:00
}
2017-12-16 14:00:38 +02:00
// Static
2015-05-11 12:05:35 -07:00
static _jQueryInterface(config) {
return this.each(function () {
2017-12-16 14:00:38 +02:00
let data = $(this).data(DATA_KEY)
const _config = typeof config === 'object' && config
2015-05-11 12:05:35 -07:00
if (!data) {
data = new ScrollSpy(this, _config)
$(this).data(DATA_KEY, data)
}
if (typeof config === 'string') {
2017-07-27 13:39:55 +03:00
if (typeof data[config] === 'undefined') {
2017-12-16 14:00:38 +02:00
throw new TypeError(`No method named "${config}"`)
}
2015-05-11 12:05:35 -07:00
data[config]()
}
})
}
}
/**
* ------------------------------------------------------------------------
* Data Api implementation
* ------------------------------------------------------------------------
*/
2015-08-18 19:22:46 -07:00
$(window).on(Event.LOAD_DATA_API, () => {
const scrollSpys = $.makeArray($(Selector.DATA_SPY))
2015-05-11 12:05:35 -07:00
for (let i = scrollSpys.length; i--;) {
const $spy = $(scrollSpys[i])
2015-05-11 12:05:35 -07:00
ScrollSpy._jQueryInterface.call($spy, $spy.data())
}
})
/**
* ------------------------------------------------------------------------
* jQuery
* ------------------------------------------------------------------------
*/
2017-12-16 14:00:38 +02:00
$.fn[NAME] = ScrollSpy._jQueryInterface
2015-05-11 12:05:35 -07:00
$.fn[NAME].Constructor = ScrollSpy
2017-12-16 14:00:38 +02:00
$.fn[NAME].noConflict = function () {
2015-05-11 12:05:35 -07:00
$.fn[NAME] = JQUERY_NO_CONFLICT
return ScrollSpy._jQueryInterface
}
return ScrollSpy
})($)
2015-05-11 12:05:35 -07:00
export default ScrollSpy