Scrollspy: improve active behaviour

This commit is contained in:
Guilherme Soares 2025-01-24 14:58:31 +00:00 committed by Mark Otto
parent 7cc78de707
commit 0b1556ffd5
2 changed files with 20 additions and 40 deletions

View File

@ -40,10 +40,10 @@ const SELECTOR_DROPDOWN_TOGGLE = '.dropdown-toggle'
const Default = {
offset: null, // TODO: v6 @deprecated, keep it for backwards compatibility reasons
rootMargin: '0px 0px -25%',
rootMargin: '0px',
smoothScroll: false,
target: null,
threshold: [0.1, 0.5, 1]
threshold: [0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1]
}
const DefaultType = {
@ -65,13 +65,10 @@ class ScrollSpy extends BaseComponent {
// this._element is the observablesContainer and config.target the menu links wrapper
this._targetLinks = new Map()
this._observableSections = new Map()
this._intersectionRatio = new Map()
this._rootElement = getComputedStyle(this._element).overflowY === 'visible' ? null : this._element
this._activeTarget = null
this._observer = null
this._previousScrollData = {
visibleEntryTop: 0,
parentScrollTop: 0
}
this.refresh() // initialize
}
@ -115,7 +112,7 @@ class ScrollSpy extends BaseComponent {
config.target = getElement(config.target) || document.body
// TODO: v6 Only for backwards compatibility reasons. Use rootMargin only
config.rootMargin = config.offset ? `${config.offset}px 0px -30%` : config.rootMargin
config.rootMargin = config.offset ? `${config.offset}px 0px 0px` : config.rootMargin
if (typeof config.threshold === 'string') {
config.threshold = config.threshold.split(',').map(value => Number.parseFloat(value))
@ -159,40 +156,21 @@ class ScrollSpy extends BaseComponent {
// The logic of selection
_observerCallback(entries) {
const targetElement = entry => this._targetLinks.get(`#${entry.target.id}`)
const activate = entry => {
this._previousScrollData.visibleEntryTop = entry.target.offsetTop
this._process(targetElement(entry))
for (const entry of entries) {
this._intersectionRatio.set(`#${entry.target.id}`, entry.intersectionRatio)
}
const parentScrollTop = (this._rootElement || document.documentElement).scrollTop
const userScrollsDown = parentScrollTop >= this._previousScrollData.parentScrollTop
this._previousScrollData.parentScrollTop = parentScrollTop
for (const entry of entries) {
if (!entry.isIntersecting) {
this._activeTarget = null
this._clearActiveClass(targetElement(entry))
continue
let maxIntersectionRatio = 0
let element = null
for (const [key, val] of this._intersectionRatio.entries()) {
if (val > maxIntersectionRatio) {
element = this._targetLinks.get(key)
maxIntersectionRatio = val
}
}
const entryIsLowerThanPrevious = entry.target.offsetTop >= this._previousScrollData.visibleEntryTop
// if we are scrolling down, pick the bigger offsetTop
if (userScrollsDown && entryIsLowerThanPrevious) {
activate(entry)
// if parent isn't scrolled, let's keep the first visible item, breaking the iteration
if (!parentScrollTop) {
return
}
continue
}
// if we are scrolling up, pick the smallest offsetTop
if (!userScrollsDown && !entryIsLowerThanPrevious) {
activate(entry)
}
if (element !== null) {
this._process(element)
}
}
@ -214,6 +192,7 @@ class ScrollSpy extends BaseComponent {
if (isVisible(observableSection)) {
this._targetLinks.set(decodeURI(anchor.hash), anchor)
this._observableSections.set(anchor.hash, observableSection)
this._intersectionRatio.set(anchor.hash, 0)
}
}
}

View File

@ -451,7 +451,7 @@ describe('ScrollSpy', () => {
})
})
it('should clear selection if above the first section', () => {
it('should remember previous selection', () => {
return new Promise(resolve => {
fixtureEl.innerHTML = [
'<div id="header" style="height: 500px;"></div>',
@ -483,9 +483,10 @@ describe('ScrollSpy', () => {
expect(spy).toHaveBeenCalled()
expect(fixtureEl.querySelectorAll('.active')).toHaveSize(1)
expect(active().getAttribute('id')).toEqual('two-link')
expect(active().getAttribute('id')).toEqual('one-link')
onScrollStop(() => {
expect(active()).toBeNull()
expect(fixtureEl.querySelectorAll('.active')).toHaveSize(1)
expect(active().getAttribute('id')).toEqual('one-link')
resolve()
}, contentEl)
scrollTo(contentEl, 0)