scrollspy.js 7.75 KB
Newer Older
fat's avatar
fat committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
import Util from './util'


/**
 * --------------------------------------------------------------------------
 * Bootstrap (v4.0.0): scrollspy.js
 * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)
 * --------------------------------------------------------------------------
 */

const ScrollSpy = (($) => {


  /**
   * ------------------------------------------------------------------------
   * Constants
   * ------------------------------------------------------------------------
   */

fat's avatar
tab es6    
fat committed
20
21
22
  const NAME               = 'scrollspy'
  const VERSION            = '4.0.0'
  const DATA_KEY           = 'bs.scrollspy'
fat's avatar
fat committed
23
24
  const EVENT_KEY          = `.${DATA_KEY}`
  const DATA_API_KEY       = '.data-api'
fat's avatar
tab es6    
fat committed
25
  const JQUERY_NO_CONFLICT = $.fn[NAME]
fat's avatar
fat committed
26

27
  const Default = {
28
    offset : 10,
fat's avatar
fat committed
29
30
    method : 'auto',
    target : ''
fat's avatar
fat committed
31
32
  }

fat's avatar
fat committed
33
34
35
36
37
38
  const DefaultType = {
    offset : 'number',
    method : 'string',
    target : '(string|element)'
  }

fat's avatar
fat committed
39
  const Event = {
fat's avatar
fat committed
40
41
42
    ACTIVATE      : `activate${EVENT_KEY}`,
    SCROLL        : `scroll${EVENT_KEY}`,
    LOAD_DATA_API : `load${EVENT_KEY}${DATA_API_KEY}`
fat's avatar
fat committed
43
44
45
  }

  const ClassName = {
Jacob Thornton's avatar
Jacob Thornton committed
46
47
48
49
    DROPDOWN_TOGGLE : 'dropdown-toggle',
    DROPDOWN_ITEM   : 'dropdown-item',
    DROPDOWN_MENU   : 'dropdown-menu',
    ACTIVE          : 'active'
fat's avatar
fat committed
50
51
52
  }

  const Selector = {
Jacob Thornton's avatar
Jacob Thornton committed
53
54
55
56
57
    DATA_SPY       : '[data-spy="scroll"]',
    ACTIVE         : '.active',
    LI_DROPDOWN    : 'li.dropdown',
    NAV_LINKS      : '.nav-link',
    DROPDOWN_ITEMS : '.dropdown-item'
fat's avatar
fat committed
58
59
  }

60
61
62
63
64
  const OffsetMethod = {
    OFFSET   : 'offset',
    POSITION : 'position'
  }

fat's avatar
fat committed
65
66
67
68
69
70
71
72
73
74

  /**
   * ------------------------------------------------------------------------
   * Class Definition
   * ------------------------------------------------------------------------
   */

  class ScrollSpy {

    constructor(element, config) {
fat's avatar
fat committed
75
      this._element       = element
fat's avatar
fat committed
76
      this._scrollElement = element.tagName === 'BODY' ? window : element
fat's avatar
fat committed
77
      this._config        = this._getConfig(config)
Jacob Thornton's avatar
Jacob Thornton committed
78
79
      this._selector      = `${this._config.target} ${Selector.NAV_LINKS},`
                          + `${this._config.target} ${Selector.DROPDOWN_ITEMS}`
fat's avatar
fat committed
80
81
82
83
84
      this._offsets       = []
      this._targets       = []
      this._activeTarget  = null
      this._scrollHeight  = 0

85
      $(this._scrollElement).on(Event.SCROLL, $.proxy(this._process, this))
fat's avatar
fat committed
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

      this.refresh()
      this._process()
    }


    // getters

    static get VERSION() {
      return VERSION
    }

    static get Default() {
      return Default
    }


    // public

    refresh() {
106
107
108
109
110
      let autoMethod = this._scrollElement !== this._scrollElement.window ?
        OffsetMethod.POSITION : OffsetMethod.OFFSET

      let offsetMethod = this._config.method === 'auto' ?
        autoMethod : this._config.method
fat's avatar
fat committed
111

112
113
      let offsetBase = offsetMethod === OffsetMethod.POSITION ?
        this._getScrollTop() : 0
fat's avatar
fat committed
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

      this._offsets = []
      this._targets = []

      this._scrollHeight = this._getScrollHeight()

      let targets = $.makeArray($(this._selector))

      targets
        .map((element) => {
          let target
          let targetSelector = Util.getSelectorFromElement(element)

          if (targetSelector) {
            target = $(targetSelector)[0]
          }

          if (target && (target.offsetWidth || target.offsetHeight)) {
            // todo (fat): remove sketch reliance on jQuery position/offset
            return [
              $(target)[offsetMethod]().top + offsetBase,
              targetSelector
            ]
          }
        })
        .filter((item)  => item)
        .sort((a, b)    => a[0] - b[0])
        .forEach((item) => {
          this._offsets.push(item[0])
          this._targets.push(item[1])
        })
    }

fat's avatar
fat committed
147
148
149
150
151
152
153
154
155
156
157
158
159
160
    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
    }

fat's avatar
fat committed
161
162
163

    // private

fat's avatar
fat committed
164
165
166
167
168
169
170
171
172
173
174
175
    _getConfig(config) {
      config = $.extend({}, Default, config)

      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}`
      }

fat's avatar
fat committed
176
177
      Util.typeCheckConfig(NAME, config, DefaultType)

fat's avatar
fat committed
178
179
180
      return config
    }

fat's avatar
fat committed
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
    _getScrollTop() {
      return this._scrollElement === window ?
          this._scrollElement.scrollY : this._scrollElement.scrollTop
    }

    _getScrollHeight() {
      return this._scrollElement.scrollHeight || Math.max(
        document.body.scrollHeight,
        document.documentElement.scrollHeight
      )
    }

    _process() {
      let scrollTop    = this._getScrollTop() + this._config.offset
      let scrollHeight = this._getScrollHeight()
      let maxScroll    = this._config.offset
        + scrollHeight
        - this._scrollElement.offsetHeight

      if (this._scrollHeight !== scrollHeight) {
        this.refresh()
      }

      if (scrollTop >= maxScroll) {
        let target = this._targets[this._targets.length - 1]

        if (this._activeTarget !== target) {
          this._activate(target)
        }
      }

      if (this._activeTarget && scrollTop < this._offsets[0]) {
        this._activeTarget = null
        this._clear()
        return
      }

      for (let i = this._offsets.length; i--;) {
        let isActiveTarget = this._activeTarget !== this._targets[i]
            && scrollTop >= this._offsets[i]
            && (this._offsets[i + 1] === undefined ||
                scrollTop < this._offsets[i + 1])

        if (isActiveTarget) {
          this._activate(this._targets[i])
        }
      }
    }

    _activate(target) {
      this._activeTarget = target

      this._clear()

Jacob Thornton's avatar
Jacob Thornton committed
235
236
237
238
239
240
      let queries = this._selector.split(',')
      queries     = queries.map((selector) => {
        return `${selector}[data-target="${target}"],` +
               `${selector}[href="${target}"]`
      })
      let $link = $(queries.join(','))
fat's avatar
fat committed
241

Jacob Thornton's avatar
Jacob Thornton committed
242
243
      if ($link.hasClass(ClassName.DROPDOWN_ITEM)) {
        $link.parent().find(ClassName.DROPDOWN_TOGGLE).addClass(ClassName.ACTIVE)
fat's avatar
fat committed
244
245
      }

Jacob Thornton's avatar
Jacob Thornton committed
246
247
      $link.addClass(ClassName.ACTIVE)

fat's avatar
fat committed
248
249
250
251
252
253
      $(this._scrollElement).trigger(Event.ACTIVATE, {
        relatedTarget: target
      })
    }

    _clear() {
Jacob Thornton's avatar
Jacob Thornton committed
254
255
      debugger
      $(this._selector).filter(ClassName.ACTIVE).removeClass(Selector.ACTIVE)
fat's avatar
fat committed
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
    }


    // static

    static _jQueryInterface(config) {
      return this.each(function () {
        let data    = $(this).data(DATA_KEY)
        let _config = typeof config === 'object' && config || null

        if (!data) {
          data = new ScrollSpy(this, _config)
          $(this).data(DATA_KEY, data)
        }

        if (typeof config === 'string') {
          data[config]()
        }
      })
    }


  }


  /**
   * ------------------------------------------------------------------------
   * Data Api implementation
   * ------------------------------------------------------------------------
   */

Jacob Thornton's avatar
Jacob Thornton committed
287
  $(window).on(Event.LOAD_DATA_API, () => {
fat's avatar
fat committed
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
    let scrollSpys = $.makeArray($(Selector.DATA_SPY))

    for (let i = scrollSpys.length; i--;) {
      let $spy = $(scrollSpys[i])
      ScrollSpy._jQueryInterface.call($spy, $spy.data())
    }
  })


  /**
   * ------------------------------------------------------------------------
   * jQuery
   * ------------------------------------------------------------------------
   */

  $.fn[NAME]             = ScrollSpy._jQueryInterface
  $.fn[NAME].Constructor = ScrollSpy
  $.fn[NAME].noConflict  = function () {
    $.fn[NAME] = JQUERY_NO_CONFLICT
    return ScrollSpy._jQueryInterface
  }

  return ScrollSpy

})(jQuery)

export default ScrollSpy