virtual-scroller 1.7.6 → 1.8.0

package/commonjs/Resize.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../source/Resize.js"],"names":["Resize","bypass","scrollableContainer","getContainerElement","updateLayout","resetStateAndLayout","isRendered","prevScrollableContainerWidth","scrollableContainerWidth","prevScrollableContainerHeight","scrollableContainerHeight","getWidth","getHeight","reason","LAYOUT_REASON","RESIZE","SCROLLABLE_CONTAINER_RESIZE_DEBOUNCE_INTERVAL","scrollableContainerUnlistenResize","onResize","container"],"mappings":";;;;;;;AAAA;;AACA;;;;;;;;;;;;IAEqBA,M;;;AACpB,wBAMG;AAAA;;AAAA,QALFC,MAKE,QALFA,MAKE;AAAA,QAJFC,mBAIE,QAJFA,mBAIE;AAAA,QAHFC,mBAGE,QAHFA,mBAGE;AAAA,QAFFC,YAEE,QAFFA,YAEE;AAAA,QADFC,mBACE,QADFA,mBACE;;AAAA;;AAAA,sCA8BQ,0BAAS,YAAM;AACzB;AACA;AACA,UAAI,CAAC,KAAI,CAACC,UAAV,EAAsB;AACrB;AACA;;AACD,UAAMC,4BAA4B,GAAG,KAAI,CAACC,wBAA1C;AACA,UAAMC,6BAA6B,GAAG,KAAI,CAACC,yBAA3C;AACA,MAAA,KAAI,CAACF,wBAAL,GAAgC,KAAI,CAACN,mBAAL,CAAyBS,QAAzB,EAAhC;AACA,MAAA,KAAI,CAACD,yBAAL,GAAiC,KAAI,CAACR,mBAAL,CAAyBU,SAAzB,EAAjC;;AACA,UAAI,KAAI,CAACJ,wBAAL,KAAkCD,4BAAtC,EAAoE;AACnE,YAAI,KAAI,CAACG,yBAAL,KAAmCD,6BAAvC,EAAsE;AACrE;AACA;AACA;AACA,SAJD,MAIO;AACN;AACA;AACA;AACA,UAAA,KAAI,CAACL,YAAL,CAAkB;AAAES,YAAAA,MAAM,EAAEC,sBAAcC;AAAxB,WAAlB;AACA;AACD,OAXD,MAWO;AACN;AACA;AACA;AACA;AACA,QAAA,KAAI,CAACV,mBAAL;AACA;AACD,KA5BU,EA4BRW,6CA5BQ,CA9BR;;AACF,SAAKf,MAAL,GAAcA,MAAd;AACA,SAAKC,mBAAL,GAA2BA,mBAA3B;AACA,SAAKC,mBAAL,GAA2BA,mBAA3B;AACA,SAAKC,YAAL,GAAoBA,YAApB;AACA,SAAKC,mBAAL,GAA2BA,mBAA3B;AACA;;;;6BAEQ;AACR,UAAI,KAAKJ,MAAT,EAAiB;AAChB;AACA;;AACD,WAAKK,UAAL,GAAkB,IAAlB;AACA,WAAKE,wBAAL,GAAgC,KAAKN,mBAAL,CAAyBS,QAAzB,EAAhC;AACA,WAAKD,yBAAL,GAAiC,KAAKR,mBAAL,CAAyBU,SAAzB,EAAjC;AACA,WAAKK,iCAAL,GAAyC,KAAKf,mBAAL,CAAyBgB,QAAzB,CAAkC,KAAKA,QAAvC,EAAiD;AACzFC,QAAAA,SAAS,EAAE,KAAKhB,mBAAL;AAD8E,OAAjD,CAAzC;AAGA;;;2BAEM;AACN,WAAKG,UAAL,GAAkB,KAAlB;;AACA,UAAI,KAAKW,iCAAT,EAA4C;AAC3C,aAAKA,iCAAL;AACA;AACD;AAED;;;;;;;;;;AAkCD,IAAMD,6CAA6C,GAAG,GAAtD","sourcesContent":["import { LAYOUT_REASON } from './Layout'\r\nimport debounce from './utility/debounce'\r\n\r\nexport default class Resize {\r\n\tconstructor({\r\n\t\tbypass,\r\n\t\tscrollableContainer,\r\n\t\tgetContainerElement,\r\n\t\tupdateLayout,\r\n\t\tresetStateAndLayout\r\n\t}) {\r\n\t\tthis.bypass = bypass\r\n\t\tthis.scrollableContainer = scrollableContainer\r\n\t\tthis.getContainerElement = getContainerElement\r\n\t\tthis.updateLayout = updateLayout\r\n\t\tthis.resetStateAndLayout = resetStateAndLayout\r\n\t}\r\n\r\n\tlisten() {\r\n\t\tif (this.bypass) {\r\n\t\t\treturn\r\n\t\t}\r\n\t\tthis.isRendered = true\r\n\t\tthis.scrollableContainerWidth = this.scrollableContainer.getWidth()\r\n\t\tthis.scrollableContainerHeight = this.scrollableContainer.getHeight()\r\n\t\tthis.scrollableContainerUnlistenResize = this.scrollableContainer.onResize(this.onResize, {\r\n\t\t\tcontainer: this.getContainerElement()\r\n\t\t})\r\n\t}\r\n\r\n\tstop() {\r\n\t\tthis.isRendered = false\r\n\t\tif (this.scrollableContainerUnlistenResize) {\r\n\t\t\tthis.scrollableContainerUnlistenResize()\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * On scrollable container resize.\r\n\t */\r\n\tonResize = debounce(() => {\r\n\t\t// If `VirtualScroller` has been unmounted\r\n\t\t// while `debounce()`'s `setTimeout()` was waiting, then exit.\r\n\t\tif (!this.isRendered) {\r\n\t\t\treturn\r\n\t\t}\r\n\t\tconst prevScrollableContainerWidth = this.scrollableContainerWidth\r\n\t\tconst prevScrollableContainerHeight = this.scrollableContainerHeight\r\n\t\tthis.scrollableContainerWidth = this.scrollableContainer.getWidth()\r\n\t\tthis.scrollableContainerHeight = this.scrollableContainer.getHeight()\r\n\t\tif (this.scrollableContainerWidth === prevScrollableContainerWidth) {\r\n\t\t\tif (this.scrollableContainerHeight === prevScrollableContainerHeight) {\r\n\t\t\t\t// The dimensions of the container didn't change,\r\n\t\t\t\t// so there's no need to re-layout anything.\r\n\t\t\t\treturn\r\n\t\t\t} else {\r\n\t\t\t\t// Scrollable container height has changed,\r\n\t\t\t\t// so just recalculate shown item indexes.\r\n\t\t\t\t// No need to perform a re-layout from scratch.\r\n\t\t\t\tthis.updateLayout({ reason: LAYOUT_REASON.RESIZE })\r\n\t\t\t}\r\n\t\t} else {\r\n\t\t\t// Reset item heights, because if scrollable container's width (or height)\r\n\t\t\t// has changed, then the list width (or height) most likely also has changed,\r\n\t\t\t// and also some CSS `@media()` rules might have been added or removed.\r\n\t\t\t// So re-render the list entirely.\r\n\t\t\tthis.resetStateAndLayout()\r\n\t\t}\r\n\t}, SCROLLABLE_CONTAINER_RESIZE_DEBOUNCE_INTERVAL)\r\n}\r\n\r\nconst SCROLLABLE_CONTAINER_RESIZE_DEBOUNCE_INTERVAL = 250"],"file":"Resize.js"}
+{"version":3,"sources":["../source/Resize.js"],"names":["Resize","bypass","scrollableContainer","onStart","onStop","onHeightChange","onWidthChange","onNoChange","isRendered","prevScrollableContainerWidth","scrollableContainerWidth","prevScrollableContainerHeight","scrollableContainerHeight","getWidth","getHeight","onResize","_onResize","SCROLLABLE_CONTAINER_RESIZE_DEBOUNCE_INTERVAL","scrollableContainerUnlistenResize","undefined"],"mappings":";;;;;;;AAAA;;AACA;;;;;;;;;;;;IAEqBA,M;AACpB,wBAQG;AAAA;;AAAA,QAPFC,MAOE,QAPFA,MAOE;AAAA,QANFC,mBAME,QANFA,mBAME;AAAA,QALFC,OAKE,QALFA,OAKE;AAAA,QAJFC,MAIE,QAJFA,MAIE;AAAA,QAHFC,cAGE,QAHFA,cAGE;AAAA,QAFFC,aAEE,QAFFA,aAEE;AAAA,QADFC,UACE,QADFA,UACE;;AAAA;;AAAA,uCAoCS,YAAM;AACjB;AACA;AACA,UAAI,CAAC,KAAI,CAACC,UAAV,EAAsB;AACrB;AACA;;AACD,UAAMC,4BAA4B,GAAG,KAAI,CAACC,wBAA1C;AACA,UAAMC,6BAA6B,GAAG,KAAI,CAACC,yBAA3C;AACA,MAAA,KAAI,CAACF,wBAAL,GAAgC,KAAI,CAACR,mBAAL,CAAyBW,QAAzB,EAAhC;AACA,MAAA,KAAI,CAACD,yBAAL,GAAiC,KAAI,CAACV,mBAAL,CAAyBY,SAAzB,EAAjC;;AACA,UAAI,KAAI,CAACJ,wBAAL,KAAkCD,4BAAtC,EAAoE;AACnE,YAAI,KAAI,CAACG,yBAAL,KAAmCD,6BAAvC,EAAsE;AACrE;AACA;AACA,UAAA,KAAI,CAACJ,UAAL;AACA,SAJD,MAIO;AACN;AACA;AACA;AACA,UAAA,KAAI,CAACF,cAAL,CAAoBM,6BAApB,EAAmD,KAAI,CAACC,yBAAxD;AACA;AACD,OAXD,MAWO;AACN;AACA;AACA;AACA;AACA,QAAA,KAAI,CAACN,aAAL,CAAmBG,4BAAnB,EAAiD,KAAI,CAACC,wBAAtD;AACA;AACD,KAhEE;;AACF,SAAKT,MAAL,GAAcA,MAAd;AACA,SAAKC,mBAAL,GAA2BA,mBAA3B;AAEA,SAAKG,cAAL,GAAsBA,cAAtB;AACA,SAAKC,aAAL,GAAqBA,aAArB;AACA,SAAKC,UAAL,GAAkBA,UAAlB;AAEA,SAAKQ,QAAL,GAAgB,0BACf,KAAKC,SADU,EAEfC,6CAFe,EAGf;AAAEd,MAAAA,OAAO,EAAPA,OAAF;AAAWC,MAAAA,MAAM,EAANA;AAAX,KAHe,CAAhB;AAKA;;;;WAED,kBAAS;AACR,UAAI,KAAKH,MAAT,EAAiB;AAChB;AACA;;AACD,WAAKO,UAAL,GAAkB,IAAlB;AACA,WAAKE,wBAAL,GAAgC,KAAKR,mBAAL,CAAyBW,QAAzB,EAAhC;AACA,WAAKD,yBAAL,GAAiC,KAAKV,mBAAL,CAAyBY,SAAzB,EAAjC;AACA,WAAKI,iCAAL,GAAyC,KAAKhB,mBAAL,CAAyBa,QAAzB,CAAkC,KAAKA,QAAvC,CAAzC;AACA;;;WAED,gBAAO;AACN,WAAKP,UAAL,GAAkB,KAAlB;;AACA,UAAI,KAAKU,iCAAT,EAA4C;AAC3C,aAAKA,iCAAL;AACA,aAAKA,iCAAL,GAAyCC,SAAzC;AACA;AACD;AAED;AACD;AACA;;;;;;;;AAgCA,IAAMF,6CAA6C,GAAG,GAAtD","sourcesContent":["import debounce from './utility/debounce'\r\nimport log from './utility/debug'\r\n\r\nexport default class Resize {\r\n\tconstructor({\r\n\t\tbypass,\r\n\t\tscrollableContainer,\r\n\t\tonStart,\r\n\t\tonStop,\r\n\t\tonHeightChange,\r\n\t\tonWidthChange,\r\n\t\tonNoChange\r\n\t}) {\r\n\t\tthis.bypass = bypass\r\n\t\tthis.scrollableContainer = scrollableContainer\r\n\r\n\t\tthis.onHeightChange = onHeightChange\r\n\t\tthis.onWidthChange = onWidthChange\r\n\t\tthis.onNoChange = onNoChange\r\n\r\n\t\tthis.onResize = debounce(\r\n\t\t\tthis._onResize,\r\n\t\t\tSCROLLABLE_CONTAINER_RESIZE_DEBOUNCE_INTERVAL,\r\n\t\t\t{ onStart, onStop }\r\n\t\t)\r\n\t}\r\n\r\n\tlisten() {\r\n\t\tif (this.bypass) {\r\n\t\t\treturn\r\n\t\t}\r\n\t\tthis.isRendered = true\r\n\t\tthis.scrollableContainerWidth = this.scrollableContainer.getWidth()\r\n\t\tthis.scrollableContainerHeight = this.scrollableContainer.getHeight()\r\n\t\tthis.scrollableContainerUnlistenResize = this.scrollableContainer.onResize(this.onResize)\r\n\t}\r\n\r\n\tstop() {\r\n\t\tthis.isRendered = false\r\n\t\tif (this.scrollableContainerUnlistenResize) {\r\n\t\t\tthis.scrollableContainerUnlistenResize()\r\n\t\t\tthis.scrollableContainerUnlistenResize = undefined\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * On scrollable container resize.\r\n\t */\r\n\t_onResize = () => {\r\n\t\t// If `VirtualScroller` has been unmounted\r\n\t\t// while `debounce()`'s `setTimeout()` was waiting, then exit.\r\n\t\tif (!this.isRendered) {\r\n\t\t\treturn\r\n\t\t}\r\n\t\tconst prevScrollableContainerWidth = this.scrollableContainerWidth\r\n\t\tconst prevScrollableContainerHeight = this.scrollableContainerHeight\r\n\t\tthis.scrollableContainerWidth = this.scrollableContainer.getWidth()\r\n\t\tthis.scrollableContainerHeight = this.scrollableContainer.getHeight()\r\n\t\tif (this.scrollableContainerWidth === prevScrollableContainerWidth) {\r\n\t\t\tif (this.scrollableContainerHeight === prevScrollableContainerHeight) {\r\n\t\t\t\t// The dimensions of the container didn't change,\r\n\t\t\t\t// so there's no need to re-layout anything.\r\n\t\t\t\tthis.onNoChange()\r\n\t\t\t} else {\r\n\t\t\t\t// Scrollable container height has changed,\r\n\t\t\t\t// so just recalculate shown item indexes.\r\n\t\t\t\t// No need to perform a re-layout from scratch.\r\n\t\t\t\tthis.onHeightChange(prevScrollableContainerHeight, this.scrollableContainerHeight)\r\n\t\t\t}\r\n\t\t} else {\r\n\t\t\t// Reset item heights, because if scrollable container's width (or height)\r\n\t\t\t// has changed, then the list width (or height) most likely also has changed,\r\n\t\t\t// and also some CSS `@media()` rules might have been added or removed.\r\n\t\t\t// So re-render the list entirely.\r\n\t\t\tthis.onWidthChange(prevScrollableContainerWidth, this.scrollableContainerWidth)\r\n\t\t}\r\n\t}\r\n}\r\n\r\nconst SCROLLABLE_CONTAINER_RESIZE_DEBOUNCE_INTERVAL = 250"],"file":"Resize.js"}

package/commonjs/Scroll.js

@@ -7,8 +7,6 @@ exports["default"] = void 0;
 
 var _requestAnimationFrameTimeout = require("request-animation-frame-timeout");
 
-var _Layout = require("./Layout");
-
 var _debug = _interopRequireDefault(require("./utility/debug"));
 
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
@@ -21,100 +19,120 @@ function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _d
 
 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; }
 
-var Scroll =
-/*#__PURE__*/
-function () {
+var Scroll = /*#__PURE__*/function () {
   function Scroll(_ref) {
     var _this = this;
 
     var bypass = _ref.bypass,
         scrollableContainer = _ref.scrollableContainer,
-        updateLayout = _ref.updateLayout,
+        itemsContainer = _ref.itemsContainer,
+        onScroll = _ref.onScroll,
         initialScrollPosition = _ref.initialScrollPosition,
         onScrollPositionChange = _ref.onScrollPositionChange,
         isImmediateLayoutScheduled = _ref.isImmediateLayoutScheduled,
         hasNonRenderedItemsAtTheTop = _ref.hasNonRenderedItemsAtTheTop,
         hasNonRenderedItemsAtTheBottom = _ref.hasNonRenderedItemsAtTheBottom,
-        getLatestLayoutVisibleAreaIncludingMargins = _ref.getLatestLayoutVisibleAreaIncludingMargins,
-        preserveScrollPositionOfTheBottomOfTheListOnMount = _ref.preserveScrollPositionOfTheBottomOfTheListOnMount;
+        getLatestLayoutVisibleArea = _ref.getLatestLayoutVisibleArea,
+        getListTopOffset = _ref.getListTopOffset,
+        getPrerenderMargin = _ref.getPrerenderMargin,
+        onScrolledToTop = _ref.onScrolledToTop,
+        waitForScrollingToStop = _ref.waitForScrollingToStop;
 
     _classCallCheck(this, Scroll);
 
-    _defineProperty(this, "updateScrollPosition", function () {
-      _this.onScrollPositionChange(_this.getScrollY());
+    _defineProperty(this, "scrollByY", function (scrollByY) {
+      _this.scrollToY(_this.getScrollY() + scrollByY);
     });
 
-    _defineProperty(this, "onScroll", function () {
-      // Prefer not performing a re-layout while the user is scrolling (if possible).
+    _defineProperty(this, "onScrollListener", function () {
+      if (_this.onScrollPositionChange) {
+        _this.onScrollPositionChange(_this.getScrollY());
+      } // If the user has scrolled up to the top of the items container.
+      // (this option isn't currently used)
+
+
+      if (_this.onScrolledToTop) {
+        if (_this.getScrollY() < _this.getListTopOffset()) {
+          _this.onScrolledToTop();
+        }
+      }
+
+      if (_this.bypass) {
+        return;
+      }
+
+      if (_this.ignoreScrollEvents) {
+        return;
+      } // Prefer not performing a re-layout while the user is scrolling (if possible).
       // If the user doesn't scroll too far and then stops for a moment,
       // then a mid-scroll re-layout could be delayed until such a brief stop:
       // presumably, this results in better (smoother) scrolling performance,
       // delaying the work to when it doesn't introduce any stutter or "jank".
-      // Reset `this.onUserStopsScrollingTimer` (will be re-created below).
-      _this.cancelOnUserStopsScrollingTimer(); // See whether rendering "new" previous/next items is required
-      // right now, or it can wait until the user stops scrolling.
+      // Reset `this.onStopScrollingTimer` (will be re-created below).
+
+
+      _this.cancelOnStopScrollingTimer(); // See if the latest "layout" (the currently rendered set of items)
+      // is still sufficient in order to show all the items that're
+      // currently inside the viewport. If there're some non-rendered items
+      // that're visible in the current viewport, then those items
+      // should be rendered "immediately" rather than waiting until
+      // the user stops scrolling.
 
 
       var forceUpdate = // If the items have been rendered at least once
-      _this.getLatestLayoutVisibleAreaIncludingMargins() && ( // If the user has scrolled up past the extra "margin"
-      _this.getScrollY() < _this.getLatestLayoutVisibleAreaIncludingMargins().top && // and if there're any previous non-rendered items to render.
-      _this.hasNonRenderedItemsAtTheTop() || // If the user has scrolled down past the extra "margin"
-      _this.getScrollY() + _this.scrollableContainer.getHeight() > _this.getLatestLayoutVisibleAreaIncludingMargins().bottom && // and if there're any next non-rendered items to render.
-      _this.hasNonRenderedItemsAtTheBottom());
+      _this.getLatestLayoutVisibleArea() && ( // If the user has scrolled up past the "prerender margin"
+      // and there're some non-rendered items at the top,
+      // then force a re-layout.
+      //
+      // (during these calculations we assume that the list's top coordinate
+      //  hasn't changed since previous layout; even if that's not exactly true,
+      //  the items will be re-layout when the user stops scrolling anyway)
+      //
+      _this.getScrollY() < _this.getLatestLayoutVisibleArea().top - _this.getPrerenderMargin() && _this.hasNonRenderedItemsAtTheTop() || // If the user has scrolled down past the "prerender margin"
+      // and there're any non-rendered items left at the end,
+      // then force a re-layout.
+      //
+      // (during these calculations we assume that the list's top coordinate
+      //  hasn't changed since previous layout; even if that's not exactly true,
+      //  the items will be re-layout when the user stops scrolling anyway)
+      //
+      _this.getScrollY() + _this.scrollableContainer.getHeight() > _this.getLatestLayoutVisibleArea().bottom + _this.getPrerenderMargin() && _this.hasNonRenderedItemsAtTheBottom());
 
       if (forceUpdate) {
-        (0, _debug["default"])('The user has scrolled far enough: force re-layout');
+        (0, _debug["default"])('The user has scrolled far enough: perform a re-layout');
       } else {
-        (0, _debug["default"])('The user hasn\'t scrolled too much: delay re-layout');
+        (0, _debug["default"])('The user is scrolling: perform a re-layout when they stop scrolling');
       }
 
-      if (!forceUpdate) {
-        // If a re-layout is already scheduled at the next "frame",
-        // don't schedule a "re-layout when user stops scrolling" timer.
-        if (_this.isImmediateLayoutScheduled()) {
-          return;
-        }
+      if (forceUpdate || _this.waitForScrollingToStop === false) {
+        return _this.onScroll();
+      } // If a re-layout is already scheduled at the next "frame",
+      // don't schedule a "re-layout when user stops scrolling" timer.
 
-        _this.onUserStopsScrollingTimer = (0, _requestAnimationFrameTimeout.setTimeout)(function () {
-          _this.onUserStopsScrollingTimer = undefined;
 
-          _this.updateLayout({
-            reason: _Layout.LAYOUT_REASON.STOPPED_SCROLLING
-          });
-        }, // "scroll" events are usually dispatched every 16 milliseconds
-        // for 60fps refresh rate, so waiting for 100 milliseconds feels
-        // reasonable: that would be about 6 frames of inactivity period,
-        // which could mean that either the user has stopped scrolling
-        // (for a moment) or the browser is lagging and stuttering
-        // (skipping frames due to high load).
-        // If the user continues scrolling then this timeout is constantly
-        // refreshed (cancelled and then re-created).
-        WAIT_FOR_USER_TO_STOP_SCROLLING_TIMEOUT);
+      if (_this.isImmediateLayoutScheduled()) {
         return;
       }
 
-      _this.updateLayout({
-        reason: _Layout.LAYOUT_REASON.SCROLL
-      });
+      _this.onScrollOnStopScrolling = true;
+
+      _this.watchOnStopScrolling();
     });
 
     this.bypass = bypass;
     this.scrollableContainer = scrollableContainer;
-    this.updateLayout = updateLayout;
+    this.itemsContainer = itemsContainer;
+    this.onScroll = onScroll;
     this.initialScrollPosition = initialScrollPosition;
     this.onScrollPositionChange = onScrollPositionChange;
     this.isImmediateLayoutScheduled = isImmediateLayoutScheduled;
     this.hasNonRenderedItemsAtTheTop = hasNonRenderedItemsAtTheTop;
     this.hasNonRenderedItemsAtTheBottom = hasNonRenderedItemsAtTheBottom;
-    this.getLatestLayoutVisibleAreaIncludingMargins = getLatestLayoutVisibleAreaIncludingMargins;
-
-    if (preserveScrollPositionOfTheBottomOfTheListOnMount) {
-      if (scrollableContainer) {
-        this.preserveScrollPositionOfTheBottomOfTheListOnMount = {
-          scrollableContainerContentHeight: scrollableContainer.getContentHeight()
-        };
-      }
-    }
+    this.getLatestLayoutVisibleArea = getLatestLayoutVisibleArea;
+    this.getListTopOffset = getListTopOffset;
+    this.getPrerenderMargin = getPrerenderMargin;
+    this.onScrolledToTop = onScrolledToTop;
+    this.waitForScrollingToStop = waitForScrollingToStop;
   }
 
   _createClass(Scroll, [{
@@ -125,71 +143,113 @@ function () {
       }
 
       if (this.onScrollPositionChange) {
-        this.updateScrollPosition();
-        this.removeScrollPositionListener = this.scrollableContainer.addScrollListener(this.updateScrollPosition);
+        this.onScrollPositionChange(this.getScrollY());
       }
 
-      if (!this.bypass) {
-        this.removeScrollListener = this.scrollableContainer.addScrollListener(this.onScroll);
-      }
-
-      if (this.preserveScrollPositionOfTheBottomOfTheListOnMount) {
-        this.scrollToY(this.getScrollY() + (this.scrollableContainer.getContentHeight() - this.preserveScrollPositionOfTheBottomOfTheListOnMount.scrollableContainerContentHeight));
-      }
+      this.stopListeningToScroll = this.scrollableContainer.onScroll(this.onScrollListener);
     }
   }, {
     key: "stop",
     value: function stop() {
-      if (this.removeScrollPositionListener) {
-        this.removeScrollPositionListener();
+      if (this.stopReportingScrollPositionChange) {
+        this.stopReportingScrollPositionChange();
+        this.stopReportingScrollPositionChange = undefined;
+      }
+
+      if (this.stopListeningToScroll) {
+        this.stopListeningToScroll();
+        this.stopListeningToScroll = undefined;
       }
 
-      if (this.removeScrollListener) {
-        this.removeScrollListener();
+      if (this.onStopScrollingListener) {
+        this.onStopScrollingListener = undefined;
       }
 
-      this.cancelOnUserStopsScrollingTimer();
+      if (this.onScrollOnStopScrolling) {
+        this.onScrollOnStopScrolling = undefined;
+      }
+
+      this.cancelOnStopScrollingTimer();
     }
   }, {
     key: "scrollToY",
     value: function scrollToY(scrollY) {
+      this.ignoreScrollEvents = true;
       this.scrollableContainer.scrollToY(scrollY);
-    }
-  }, {
-    key: "scrollByY",
-    value: function scrollByY(_scrollByY) {
-      this.scrollToY(this.getScrollY() + _scrollByY);
+      this.ignoreScrollEvents = undefined;
     }
   }, {
     key: "getScrollY",
     value: function getScrollY() {
       return this.scrollableContainer.getScrollY();
     }
-    /**
-     * Updates the current scroll Y position in state.
-     */
-
   }, {
-    key: "cancelOnUserStopsScrollingTimer",
-    value: function cancelOnUserStopsScrollingTimer() {
-      if (this.onUserStopsScrollingTimer) {
-        (0, _requestAnimationFrameTimeout.clearTimeout)(this.onUserStopsScrollingTimer);
-        this.onUserStopsScrollingTimer = undefined;
+    key: "cancelOnStopScrollingTimer",
+    value: function cancelOnStopScrollingTimer() {
+      if (this.onStopScrollingTimer) {
+        (0, _requestAnimationFrameTimeout.clearTimeout)(this.onStopScrollingTimer);
+        this.onStopScrollingTimer = undefined;
       }
     }
   }, {
-    key: "onLayout",
-    value: function onLayout() {
+    key: "cancelScheduledLayout",
+    value: function cancelScheduledLayout() {
       // Cancel a "re-layout when user stops scrolling" timer.
-      this.cancelOnUserStopsScrollingTimer();
+      this.cancelOnStopScrollingTimer();
     }
   }, {
-    key: "getVisibleAreaBounds",
+    key: "watchOnStopScrolling",
+    value: function watchOnStopScrolling() {
+      var _this2 = this;
+
+      this.onStopScrollingTimer = (0, _requestAnimationFrameTimeout.setTimeout)(function () {
+        _this2.onStopScrollingTimer = undefined;
 
+        if (_this2.onScrollOnStopScrolling) {
+          _this2.onScrollOnStopScrolling = undefined;
+
+          _this2.onScroll({
+            delayed: true
+          });
+        }
+
+        if (_this2.onStopScrollingListener) {
+          var onStopScrollingListener = _this2.onStopScrollingListener;
+          _this2.onStopScrollingListener = undefined; // `onStopScrollingListener()` may hypothetically schedule
+          // another `onStopScrolling()` listener, so set
+          // `this.onStopScrollingListener` to `undefined` before
+          // calling it rather than after.
+
+          (0, _debug["default"])('~ The user has stopped scrolling ~');
+          onStopScrollingListener();
+        }
+      }, // "scroll" events are usually dispatched every 16 milliseconds
+      // for 60fps refresh rate, so waiting for 100 milliseconds feels
+      // reasonable: that would be about 6 frames of inactivity period,
+      // which could mean that either the user has stopped scrolling
+      // (for a moment) or the browser is lagging and stuttering
+      // (skipping frames due to high load).
+      // If the user continues scrolling then this timeout is constantly
+      // refreshed (cancelled and then re-created).
+      ON_STOP_SCROLLING_INACTIVE_PERIOD);
+    } // (this function isn't currently used)
+
+  }, {
+    key: "onStopScrolling",
+    value: function onStopScrolling(onStopScrollingListener) {
+      this.onStopScrollingListener = onStopScrollingListener;
+
+      if (!this.onStopScrollingTimer) {
+        this.watchOnStopScrolling();
+      }
+    }
     /**
      * Returns visible area coordinates relative to the scrollable container.
      * @return {object} `{ top: number, bottom: number }`
      */
+
+  }, {
+    key: "getVisibleAreaBounds",
     value: function getVisibleAreaBounds() {
       var scrollY = this.getScrollY();
       return {
@@ -205,5 +265,5 @@ function () {
 }();
 
 exports["default"] = Scroll;
-var WAIT_FOR_USER_TO_STOP_SCROLLING_TIMEOUT = 100;
+var ON_STOP_SCROLLING_INACTIVE_PERIOD = 100;
 //# sourceMappingURL=Scroll.js.map

package/commonjs/Scroll.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../source/Scroll.js"],"names":["Scroll","bypass","scrollableContainer","updateLayout","initialScrollPosition","onScrollPositionChange","isImmediateLayoutScheduled","hasNonRenderedItemsAtTheTop","hasNonRenderedItemsAtTheBottom","getLatestLayoutVisibleAreaIncludingMargins","preserveScrollPositionOfTheBottomOfTheListOnMount","getScrollY","cancelOnUserStopsScrollingTimer","forceUpdate","top","getHeight","bottom","onUserStopsScrollingTimer","undefined","reason","LAYOUT_REASON","STOPPED_SCROLLING","WAIT_FOR_USER_TO_STOP_SCROLLING_TIMEOUT","SCROLL","scrollableContainerContentHeight","getContentHeight","scrollToY","updateScrollPosition","removeScrollPositionListener","addScrollListener","removeScrollListener","onScroll","scrollY","scrollByY"],"mappings":"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","sourcesContent":["// For some weird reason, in Chrome, `setTimeout()` would lag up to a second (or more) behind.\r\n// Turns out, Chrome developers have deprecated `setTimeout()` API entirely without asking anyone.\r\n// Replacing `setTimeout()` with `requestAnimationFrame()` can work around that Chrome bug.\r\n// https://github.com/bvaughn/react-virtualized/issues/722\r\nimport { setTimeout, clearTimeout } from 'request-animation-frame-timeout'\r\n\r\nimport { LAYOUT_REASON } from './Layout'\r\nimport log from './utility/debug'\r\n\r\nexport default class Scroll {\r\n\tconstructor({\r\n\t\tbypass,\r\n\t\tscrollableContainer,\r\n\t\tupdateLayout,\r\n\t\tinitialScrollPosition,\r\n\t\tonScrollPositionChange,\r\n\t\tisImmediateLayoutScheduled,\r\n\t\thasNonRenderedItemsAtTheTop,\r\n\t\thasNonRenderedItemsAtTheBottom,\r\n\t\tgetLatestLayoutVisibleAreaIncludingMargins,\r\n\t\tpreserveScrollPositionOfTheBottomOfTheListOnMount\r\n\t}) {\r\n\t\tthis.bypass = bypass\r\n\t\tthis.scrollableContainer = scrollableContainer\r\n\t\tthis.updateLayout = updateLayout\r\n\t\tthis.initialScrollPosition = initialScrollPosition\r\n\t\tthis.onScrollPositionChange = onScrollPositionChange\r\n\t\tthis.isImmediateLayoutScheduled = isImmediateLayoutScheduled\r\n\t\tthis.hasNonRenderedItemsAtTheTop = hasNonRenderedItemsAtTheTop\r\n\t\tthis.hasNonRenderedItemsAtTheBottom = hasNonRenderedItemsAtTheBottom\r\n\t\tthis.getLatestLayoutVisibleAreaIncludingMargins = getLatestLayoutVisibleAreaIncludingMargins\r\n\r\n\t\tif (preserveScrollPositionOfTheBottomOfTheListOnMount) {\r\n\t\t\tif (scrollableContainer) {\r\n\t\t\t\tthis.preserveScrollPositionOfTheBottomOfTheListOnMount = {\r\n\t\t\t\t\tscrollableContainerContentHeight: scrollableContainer.getContentHeight()\r\n\t\t\t\t}\r\n\t\t\t}\r\n\t\t}\r\n\t}\r\n\r\n\tlisten() {\r\n\t\tif (this.initialScrollPosition !== undefined) {\r\n\t\t\tthis.scrollToY(this.initialScrollPosition)\r\n\t\t}\r\n\t\tif (this.onScrollPositionChange) {\r\n\t\t\tthis.updateScrollPosition()\r\n\t\t\tthis.removeScrollPositionListener = this.scrollableContainer.addScrollListener(this.updateScrollPosition)\r\n\t\t}\r\n\t\tif (!this.bypass) {\r\n\t\t\tthis.removeScrollListener = this.scrollableContainer.addScrollListener(this.onScroll)\r\n\t\t}\r\n\t\tif (this.preserveScrollPositionOfTheBottomOfTheListOnMount) {\r\n\t\t\tthis.scrollToY(this.getScrollY() + (this.scrollableContainer.getContentHeight() - this.preserveScrollPositionOfTheBottomOfTheListOnMount.scrollableContainerContentHeight))\r\n\t\t}\r\n\t}\r\n\r\n\tstop() {\r\n\t\tif (this.removeScrollPositionListener) {\r\n\t\t\tthis.removeScrollPositionListener()\r\n\t\t}\r\n\t\tif (this.removeScrollListener) {\r\n\t\t\tthis.removeScrollListener()\r\n\t\t}\r\n\t\tthis.cancelOnUserStopsScrollingTimer()\r\n\t}\r\n\r\n\tscrollToY(scrollY) {\r\n\t\tthis.scrollableContainer.scrollToY(scrollY)\r\n\t}\r\n\r\n\tscrollByY(scrollByY) {\r\n\t\tthis.scrollToY(this.getScrollY() + scrollByY)\r\n\t}\r\n\r\n\tgetScrollY() {\r\n\t\treturn this.scrollableContainer.getScrollY()\r\n\t}\r\n\r\n\t/**\r\n\t * Updates the current scroll Y position in state.\r\n\t */\r\n\tupdateScrollPosition = () => {\r\n\t\tthis.onScrollPositionChange(this.getScrollY())\r\n\t}\r\n\r\n\tcancelOnUserStopsScrollingTimer() {\r\n\t\tif (this.onUserStopsScrollingTimer) {\r\n\t\t\tclearTimeout(this.onUserStopsScrollingTimer)\r\n\t\t\tthis.onUserStopsScrollingTimer = undefined\r\n\t\t}\r\n\t}\r\n\r\n\tonLayout() {\r\n\t\t// Cancel a \"re-layout when user stops scrolling\" timer.\r\n\t\tthis.cancelOnUserStopsScrollingTimer()\r\n\t}\r\n\r\n\tonScroll = () => {\r\n\t\t// Prefer not performing a re-layout while the user is scrolling (if possible).\r\n\t\t// If the user doesn't scroll too far and then stops for a moment,\r\n\t\t// then a mid-scroll re-layout could be delayed until such a brief stop:\r\n\t\t// presumably, this results in better (smoother) scrolling performance,\r\n\t\t// delaying the work to when it doesn't introduce any stutter or \"jank\".\r\n\r\n\t\t// Reset `this.onUserStopsScrollingTimer` (will be re-created below).\r\n\t\tthis.cancelOnUserStopsScrollingTimer()\r\n\r\n\t\t// See whether rendering \"new\" previous/next items is required\r\n\t\t// right now, or it can wait until the user stops scrolling.\r\n\t\tconst forceUpdate =\r\n\t\t\t// If the items have been rendered at least once\r\n\t\t\tthis.getLatestLayoutVisibleAreaIncludingMargins() && (\r\n\t\t\t\t(\r\n\t\t\t\t\t// If the user has scrolled up past the extra \"margin\"\r\n\t\t\t\t\t(this.getScrollY() < this.getLatestLayoutVisibleAreaIncludingMargins().top) &&\r\n\t\t\t\t\t// and if there're any previous non-rendered items to render.\r\n\t\t\t\t\tthis.hasNonRenderedItemsAtTheTop()\r\n\t\t\t\t)\r\n\t\t\t\t||\r\n\t\t\t\t(\r\n\t\t\t\t\t// If the user has scrolled down past the extra \"margin\"\r\n\t\t\t\t\t(this.getScrollY() + this.scrollableContainer.getHeight() > this.getLatestLayoutVisibleAreaIncludingMargins().bottom) &&\r\n\t\t\t\t\t// and if there're any next non-rendered items to render.\r\n\t\t\t\t\tthis.hasNonRenderedItemsAtTheBottom()\r\n\t\t\t\t)\r\n\t\t\t)\r\n\r\n\t\tif (forceUpdate) {\r\n\t\t\tlog('The user has scrolled far enough: force re-layout')\r\n\t\t} else {\r\n\t\t\tlog('The user hasn\\'t scrolled too much: delay re-layout')\r\n\t\t}\r\n\r\n\t\tif (!forceUpdate) {\r\n\t\t\t// If a re-layout is already scheduled at the next \"frame\",\r\n\t\t\t// don't schedule a \"re-layout when user stops scrolling\" timer.\r\n\t\t\tif (this.isImmediateLayoutScheduled()) {\r\n\t\t\t\treturn\r\n\t\t\t}\r\n\t\t\tthis.onUserStopsScrollingTimer = setTimeout(\r\n\t\t\t\t() => {\r\n\t\t\t\t\tthis.onUserStopsScrollingTimer = undefined\r\n\t\t\t\t\tthis.updateLayout({ reason: LAYOUT_REASON.STOPPED_SCROLLING })\r\n\t\t\t\t},\r\n\t\t\t\t// \"scroll\" events are usually dispatched every 16 milliseconds\r\n\t\t\t\t// for 60fps refresh rate, so waiting for 100 milliseconds feels\r\n\t\t\t\t// reasonable: that would be about 6 frames of inactivity period,\r\n\t\t\t\t// which could mean that either the user has stopped scrolling\r\n\t\t\t\t// (for a moment) or the browser is lagging and stuttering\r\n\t\t\t\t// (skipping frames due to high load).\r\n\t\t\t\t// If the user continues scrolling then this timeout is constantly\r\n\t\t\t\t// refreshed (cancelled and then re-created).\r\n\t\t\t\tWAIT_FOR_USER_TO_STOP_SCROLLING_TIMEOUT\r\n\t\t\t)\r\n\t\t\treturn\r\n\t\t}\r\n\r\n\t\tthis.updateLayout({ reason: LAYOUT_REASON.SCROLL })\r\n\t}\r\n\r\n\t/**\r\n\t * Returns visible area coordinates relative to the scrollable container.\r\n\t * @return {object} `{ top: number, bottom: number }`\r\n\t */\r\n\tgetVisibleAreaBounds() {\r\n\t\tconst scrollY = this.getScrollY()\r\n\t\treturn {\r\n\t\t\t// The first pixel of the screen.\r\n\t\t\ttop: scrollY,\r\n\t\t\t// The pixel after the last pixel of the screen.\r\n\t\t\tbottom: scrollY + this.scrollableContainer.getHeight()\r\n\t\t}\r\n\t}\r\n}\r\n\r\nconst WAIT_FOR_USER_TO_STOP_SCROLLING_TIMEOUT = 100"],"file":"Scroll.js"}
+{"version":3,"sources":["../source/Scroll.js"],"names":["Scroll","bypass","scrollableContainer","itemsContainer","onScroll","initialScrollPosition","onScrollPositionChange","isImmediateLayoutScheduled","hasNonRenderedItemsAtTheTop","hasNonRenderedItemsAtTheBottom","getLatestLayoutVisibleArea","getListTopOffset","getPrerenderMargin","onScrolledToTop","waitForScrollingToStop","scrollByY","scrollToY","getScrollY","ignoreScrollEvents","cancelOnStopScrollingTimer","forceUpdate","top","getHeight","bottom","onScrollOnStopScrolling","watchOnStopScrolling","undefined","stopListeningToScroll","onScrollListener","stopReportingScrollPositionChange","onStopScrollingListener","scrollY","onStopScrollingTimer","delayed","ON_STOP_SCROLLING_INACTIVE_PERIOD"],"mappings":"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","sourcesContent":["// For some weird reason, in Chrome, `setTimeout()` would lag up to a second (or more) behind.\r\n// Turns out, Chrome developers have deprecated `setTimeout()` API entirely without asking anyone.\r\n// Replacing `setTimeout()` with `requestAnimationFrame()` can work around that Chrome bug.\r\n// https://github.com/bvaughn/react-virtualized/issues/722\r\nimport { setTimeout, clearTimeout } from 'request-animation-frame-timeout'\r\n\r\nimport log from './utility/debug'\r\n\r\nexport default class Scroll {\r\n\tconstructor({\r\n\t\tbypass,\r\n\t\tscrollableContainer,\r\n\t\titemsContainer,\r\n\t\tonScroll,\r\n\t\tinitialScrollPosition,\r\n\t\tonScrollPositionChange,\r\n\t\tisImmediateLayoutScheduled,\r\n\t\thasNonRenderedItemsAtTheTop,\r\n\t\thasNonRenderedItemsAtTheBottom,\r\n\t\tgetLatestLayoutVisibleArea,\r\n\t\tgetListTopOffset,\r\n\t\tgetPrerenderMargin,\r\n\t\tonScrolledToTop,\r\n\t\twaitForScrollingToStop\r\n\t}) {\r\n\t\tthis.bypass = bypass\r\n\t\tthis.scrollableContainer = scrollableContainer\r\n\t\tthis.itemsContainer = itemsContainer\r\n\t\tthis.onScroll = onScroll\r\n\t\tthis.initialScrollPosition = initialScrollPosition\r\n\t\tthis.onScrollPositionChange = onScrollPositionChange\r\n\t\tthis.isImmediateLayoutScheduled = isImmediateLayoutScheduled\r\n\t\tthis.hasNonRenderedItemsAtTheTop = hasNonRenderedItemsAtTheTop\r\n\t\tthis.hasNonRenderedItemsAtTheBottom = hasNonRenderedItemsAtTheBottom\r\n\t\tthis.getLatestLayoutVisibleArea = getLatestLayoutVisibleArea\r\n\t\tthis.getListTopOffset = getListTopOffset\r\n\t\tthis.getPrerenderMargin = getPrerenderMargin\r\n\t\tthis.onScrolledToTop = onScrolledToTop\r\n\t\tthis.waitForScrollingToStop = waitForScrollingToStop\r\n\t}\r\n\r\n\tlisten() {\r\n\t\tif (this.initialScrollPosition !== undefined) {\r\n\t\t\tthis.scrollToY(this.initialScrollPosition)\r\n\t\t}\r\n\t\tif (this.onScrollPositionChange) {\r\n\t\t\tthis.onScrollPositionChange(this.getScrollY())\r\n\t\t}\r\n\t\tthis.stopListeningToScroll = this.scrollableContainer.onScroll(this.onScrollListener)\r\n\t}\r\n\r\n\tstop() {\r\n\t\tif (this.stopReportingScrollPositionChange) {\r\n\t\t\tthis.stopReportingScrollPositionChange()\r\n\t\t\tthis.stopReportingScrollPositionChange = undefined\r\n\t\t}\r\n\t\tif (this.stopListeningToScroll) {\r\n\t\t\tthis.stopListeningToScroll()\r\n\t\t\tthis.stopListeningToScroll = undefined\r\n\t\t}\r\n\t\tif (this.onStopScrollingListener) {\r\n\t\t\tthis.onStopScrollingListener = undefined\r\n\t\t}\r\n\t\tif (this.onScrollOnStopScrolling) {\r\n\t\t\tthis.onScrollOnStopScrolling = undefined\r\n\t\t}\r\n\t\tthis.cancelOnStopScrollingTimer()\r\n\t}\r\n\r\n\tscrollToY(scrollY) {\r\n\t\tthis.ignoreScrollEvents = true\r\n\t\tthis.scrollableContainer.scrollToY(scrollY)\r\n\t\tthis.ignoreScrollEvents = undefined\r\n\t}\r\n\r\n\tscrollByY = (scrollByY) => {\r\n\t\tthis.scrollToY(this.getScrollY() + scrollByY)\r\n\t}\r\n\r\n\tgetScrollY() {\r\n\t\treturn this.scrollableContainer.getScrollY()\r\n\t}\r\n\r\n\tcancelOnStopScrollingTimer() {\r\n\t\tif (this.onStopScrollingTimer) {\r\n\t\t\tclearTimeout(this.onStopScrollingTimer)\r\n\t\t\tthis.onStopScrollingTimer = undefined\r\n\t\t}\r\n\t}\r\n\r\n\tcancelScheduledLayout() {\r\n\t\t// Cancel a \"re-layout when user stops scrolling\" timer.\r\n\t\tthis.cancelOnStopScrollingTimer()\r\n\t}\r\n\r\n\tonScrollListener = () => {\r\n\t\tif (this.onScrollPositionChange) {\r\n\t\t\tthis.onScrollPositionChange(this.getScrollY())\r\n\t\t}\r\n\r\n\t\t// If the user has scrolled up to the top of the items container.\r\n\t\t// (this option isn't currently used)\r\n\t\tif (this.onScrolledToTop) {\r\n\t\t\tif (this.getScrollY() < this.getListTopOffset()) {\r\n\t\t\t\tthis.onScrolledToTop()\r\n\t\t\t}\r\n\t\t}\r\n\r\n\t\tif (this.bypass) {\r\n\t\t\treturn\r\n\t\t}\r\n\r\n\t\tif (this.ignoreScrollEvents) {\r\n\t\t\treturn\r\n\t\t}\r\n\r\n\t\t// Prefer not performing a re-layout while the user is scrolling (if possible).\r\n\t\t// If the user doesn't scroll too far and then stops for a moment,\r\n\t\t// then a mid-scroll re-layout could be delayed until such a brief stop:\r\n\t\t// presumably, this results in better (smoother) scrolling performance,\r\n\t\t// delaying the work to when it doesn't introduce any stutter or \"jank\".\r\n\r\n\t\t// Reset `this.onStopScrollingTimer` (will be re-created below).\r\n\t\tthis.cancelOnStopScrollingTimer()\r\n\r\n\t\t// See if the latest \"layout\" (the currently rendered set of items)\r\n\t\t// is still sufficient in order to show all the items that're\r\n\t\t// currently inside the viewport. If there're some non-rendered items\r\n\t\t// that're visible in the current viewport, then those items\r\n\t\t// should be rendered \"immediately\" rather than waiting until\r\n\t\t// the user stops scrolling.\r\n\t\tconst forceUpdate =\r\n\t\t\t// If the items have been rendered at least once\r\n\t\t\tthis.getLatestLayoutVisibleArea() && (\r\n\t\t\t\t(\r\n\t\t\t\t\t// If the user has scrolled up past the \"prerender margin\"\r\n\t\t\t\t\t// and there're some non-rendered items at the top,\r\n\t\t\t\t\t// then force a re-layout.\r\n\t\t\t\t\t//\r\n\t\t\t\t\t// (during these calculations we assume that the list's top coordinate\r\n\t\t\t\t\t//  hasn't changed since previous layout; even if that's not exactly true,\r\n\t\t\t\t\t//  the items will be re-layout when the user stops scrolling anyway)\r\n\t\t\t\t\t//\r\n\t\t\t\t\t(this.getScrollY() < this.getLatestLayoutVisibleArea().top - this.getPrerenderMargin()) &&\r\n\t\t\t\t\tthis.hasNonRenderedItemsAtTheTop()\r\n\t\t\t\t)\r\n\t\t\t\t||\r\n\t\t\t\t(\r\n\t\t\t\t\t// If the user has scrolled down past the \"prerender margin\"\r\n\t\t\t\t\t// and there're any non-rendered items left at the end,\r\n\t\t\t\t\t// then force a re-layout.\r\n\t\t\t\t\t//\r\n\t\t\t\t\t// (during these calculations we assume that the list's top coordinate\r\n\t\t\t\t\t//  hasn't changed since previous layout; even if that's not exactly true,\r\n\t\t\t\t\t//  the items will be re-layout when the user stops scrolling anyway)\r\n\t\t\t\t\t//\r\n\t\t\t\t\t(this.getScrollY() + this.scrollableContainer.getHeight() > this.getLatestLayoutVisibleArea().bottom + this.getPrerenderMargin()) &&\r\n\t\t\t\t\tthis.hasNonRenderedItemsAtTheBottom()\r\n\t\t\t\t)\r\n\t\t\t)\r\n\r\n\t\tif (forceUpdate) {\r\n\t\t\tlog('The user has scrolled far enough: perform a re-layout')\r\n\t\t} else {\r\n\t\t\tlog('The user is scrolling: perform a re-layout when they stop scrolling')\r\n\t\t}\r\n\r\n\t\tif (forceUpdate || this.waitForScrollingToStop === false) {\r\n\t\t\treturn this.onScroll()\r\n\t\t}\r\n\r\n\t\t// If a re-layout is already scheduled at the next \"frame\",\r\n\t\t// don't schedule a \"re-layout when user stops scrolling\" timer.\r\n\t\tif (this.isImmediateLayoutScheduled()) {\r\n\t\t\treturn\r\n\t\t}\r\n\r\n\t\tthis.onScrollOnStopScrolling = true\r\n\t\tthis.watchOnStopScrolling()\r\n\t}\r\n\r\n\twatchOnStopScrolling() {\r\n\t\tthis.onStopScrollingTimer = setTimeout(\r\n\t\t\t() => {\r\n\t\t\t\tthis.onStopScrollingTimer = undefined\r\n\r\n\t\t\t\tif (this.onScrollOnStopScrolling) {\r\n\t\t\t\t\tthis.onScrollOnStopScrolling = undefined\r\n\t\t\t\t\tthis.onScroll({ delayed: true })\r\n\t\t\t\t}\r\n\r\n\t\t\t\tif (this.onStopScrollingListener) {\r\n\t\t\t\t\tconst onStopScrollingListener = this.onStopScrollingListener\r\n\t\t\t\t\tthis.onStopScrollingListener = undefined\r\n\t\t\t\t\t// `onStopScrollingListener()` may hypothetically schedule\r\n\t\t\t\t\t// another `onStopScrolling()` listener, so set\r\n\t\t\t\t\t// `this.onStopScrollingListener` to `undefined` before\r\n\t\t\t\t\t// calling it rather than after.\r\n\t\t\t\t\tlog('~ The user has stopped scrolling ~')\r\n\t\t\t\t\tonStopScrollingListener()\r\n\t\t\t\t}\r\n\t\t\t},\r\n\t\t\t// \"scroll\" events are usually dispatched every 16 milliseconds\r\n\t\t\t// for 60fps refresh rate, so waiting for 100 milliseconds feels\r\n\t\t\t// reasonable: that would be about 6 frames of inactivity period,\r\n\t\t\t// which could mean that either the user has stopped scrolling\r\n\t\t\t// (for a moment) or the browser is lagging and stuttering\r\n\t\t\t// (skipping frames due to high load).\r\n\t\t\t// If the user continues scrolling then this timeout is constantly\r\n\t\t\t// refreshed (cancelled and then re-created).\r\n\t\t\tON_STOP_SCROLLING_INACTIVE_PERIOD\r\n\t\t)\r\n\t}\r\n\r\n\t// (this function isn't currently used)\r\n\tonStopScrolling(onStopScrollingListener) {\r\n\t\tthis.onStopScrollingListener = onStopScrollingListener\r\n\t\tif (!this.onStopScrollingTimer) {\r\n\t\t\tthis.watchOnStopScrolling()\r\n\t\t}\r\n\t}\r\n\r\n\t/**\r\n\t * Returns visible area coordinates relative to the scrollable container.\r\n\t * @return {object} `{ top: number, bottom: number }`\r\n\t */\r\n\tgetVisibleAreaBounds() {\r\n\t\tconst scrollY = this.getScrollY()\r\n\t\treturn {\r\n\t\t\t// The first pixel of the screen.\r\n\t\t\ttop: scrollY,\r\n\t\t\t// The pixel after the last pixel of the screen.\r\n\t\t\tbottom: scrollY + this.scrollableContainer.getHeight()\r\n\t\t}\r\n\t}\r\n}\r\n\r\nconst ON_STOP_SCROLLING_INACTIVE_PERIOD = 100"],"file":"Scroll.js"}