ng-virtual-list 21.9.4 → 21.9.5

package/README.md

@@ -751,6 +751,10 @@ Methods
 | scrollToEnd | (cb?: () => void, options?: [IScrollOptions](https://github.com/DjonnyX/ng-virtual-list/blob/21.x/projects/ng-virtual-list/src/lib/models/scroll-options.model.ts)) | Scrolls the scroll area to the last item in the collection. |
 | getItemBounds | (id: [Id](https://github.com/DjonnyX/ng-virtual-list/blob/21.x/projects/ng-virtual-list/src/lib/types/id.ts), behavior?: ScrollBehavior) => void | Returns the bounds of an element with a given id |
 | focus | [Id](https://github.com/DjonnyX/ng-virtual-list/blob/21.x/projects/ng-virtual-list/src/lib/types/id.ts), align: [FocusAlignment](https://github.com/DjonnyX/ng-virtual-list/blob/21.x/projects/ng-virtual-list/src/lib/types/focus-alignment.ts) = [FocusAlignments.NONE](https://github.com/DjonnyX/ng-virtual-list/blob/21.x/projects/ng-virtual-list/src/lib/enums/focus-alignments.ts) | Focus an list item by a given id. |
+| cacheClean |  | Force clearing the cache. |
+| stopSnappingScrollToEnd |  | Stops the list from snapping to the bottom edge. |
+| updateImmediately |  | Instantly refreshes the list. |
+| markForUpdate |  | Marks the list for an update that will trigger on the next tick. |
 
 <br/>
 
@@ -776,13 +780,13 @@ Properties
 
 | Angular version | ng-virtual-list version | git | npm |
 |--|--|--|--|
-| 20.x | 20.9.3 | [20.x](https://github.com/DjonnyX/ng-virtual-list/tree/20.x) | [20.9.3](https://www.npmjs.com/package/ng-virtual-list/v/20.9.3) |
-| 19.x | 19.9.5 | [19.x](https://github.com/DjonnyX/ng-virtual-list/tree/19.x) | [19.9.5](https://www.npmjs.com/package/ng-virtual-list/v/19.9.5) |
-| 18.x | 18.9.3 | [18.x](https://github.com/DjonnyX/ng-virtual-list/tree/18.x) | [18.9.3](https://www.npmjs.com/package/ng-virtual-list/v/18.9.3) |
-| 17.x | 17.9.3 | [17.x](https://github.com/DjonnyX/ng-virtual-list/tree/17.x) | [17.9.3](https://www.npmjs.com/package/ng-virtual-list/v/17.9.3) |
-| 16.x | 16.9.4 | [16.x](https://github.com/DjonnyX/ng-virtual-list/tree/16.x) | [16.9.4](https://www.npmjs.com/package/ng-virtual-list/v/16.9.4) |
-| 15.x | 15.9.4 | [15.x](https://github.com/DjonnyX/ng-virtual-list/tree/15.x) | [15.9.4](https://www.npmjs.com/package/ng-virtual-list/v/15.9.4) |
-| 14.x | 14.9.4 | [14.x](https://github.com/DjonnyX/ng-virtual-list/tree/14.x) | [14.9.4](https://www.npmjs.com/package/ng-virtual-list/v/14.9.4) |
+| 20.x | 20.9.6 | [20.x](https://github.com/DjonnyX/ng-virtual-list/tree/20.x) | [20.9.6](https://www.npmjs.com/package/ng-virtual-list/v/20.9.6) |
+| 19.x | 19.9.6 | [19.x](https://github.com/DjonnyX/ng-virtual-list/tree/19.x) | [19.9.6](https://www.npmjs.com/package/ng-virtual-list/v/19.9.6) |
+| 18.x | 18.9.4 | [18.x](https://github.com/DjonnyX/ng-virtual-list/tree/18.x) | [18.9.4](https://www.npmjs.com/package/ng-virtual-list/v/18.9.4) |
+| 17.x | 17.9.4 | [17.x](https://github.com/DjonnyX/ng-virtual-list/tree/17.x) | [17.9.4](https://www.npmjs.com/package/ng-virtual-list/v/17.9.4) |
+| 16.x | 16.9.6 | [16.x](https://github.com/DjonnyX/ng-virtual-list/tree/16.x) | [16.9.6](https://www.npmjs.com/package/ng-virtual-list/v/16.9.6) |
+| 15.x | 15.9.6 | [15.x](https://github.com/DjonnyX/ng-virtual-list/tree/15.x) | [15.9.6](https://www.npmjs.com/package/ng-virtual-list/v/15.9.6) |
+| 14.x | 14.9.6 | [14.x](https://github.com/DjonnyX/ng-virtual-list/tree/14.x) | [14.9.6](https://www.npmjs.com/package/ng-virtual-list/v/14.9.6) |
 
 <br/>
 

package/fesm2022/ng-virtual-list.mjs

@@ -345,8 +345,8 @@ class NgVirtualListService {
             this.select(data);
         }
     }
-    update() {
-        this._trackBox?.changes();
+    update(immediately = false) {
+        this._trackBox?.changes(immediately);
     }
     /**
      * Selects a list item
@@ -1202,14 +1202,14 @@ class CacheMap extends EventEmitter {
     }
     stopLifeCircle() {
         if (this._lifeCircleId !== undefined) {
-            cancelAnimationFrame(this._lifeCircleId);
+            clearTimeout(this._lifeCircleId);
         }
     }
     nextTick(cb) {
         if (this._disposed) {
             return;
         }
-        this._lifeCircleId = requestAnimationFrame(() => {
+        this._lifeCircleId = setTimeout(() => {
             cb();
         });
         return this._lifeCircleId;
@@ -2186,8 +2186,15 @@ class TrackBox extends CacheMap {
             this.clearScrollDirectionCache();
         }
     }
-    changes() {
+    changes(immediately = false) {
+        if (this.changesDetected()) {
+            return;
+        }
         this.bumpVersion();
+        if (immediately) {
+            this._previousVersion = this._version;
+            this.dispatch(CACHE_BOX_CHANGE_EVENT_NAME, this.version);
+        }
     }
     generateDisplayCollection(items, itemConfigMap, metrics) {
         const { offsetY, offsetX, width, height, normalizedItemWidth, normalizedItemHeight, dynamicSize, itemsOnDisplayLength, itemsFromStartToScrollEnd, isVertical, renderItems: renderItemsLength, scrollSize, sizeProperty, snap, snippedPos, startPosition, totalLength, startIndex, typicalItemSize, } = metrics, displayItems = [];
@@ -4531,20 +4538,24 @@ class NgVirtualListComponent {
                         scrollerComponent.prepared = true;
                     }
                     this.classes.set({ prepared: true, [READY_TO_START]: true, [WAIT_FOR_PREPARATION]: waitForPreparation });
+                    this.updateImmediately();
                 }
             }
         }), filter$1(v => !!v), delay(0), takeUntilDestroyed(this._destroyRef), tap(v => {
             prepared = v;
+            this.updateImmediately();
         }), delay(0), takeUntilDestroyed(this._destroyRef), tap(v => {
             const waitForPreparation = this.waitForPreparation(), scrollerComponent = this._scrollerComponent(), val = v || !waitForPreparation;
             if (scrollerComponent) {
                 scrollerComponent.prepared = val;
             }
             this.classes.set({ prepared: val, [WAIT_FOR_PREPARATION]: waitForPreparation });
+            this.updateImmediately();
         }), delay(1000), takeUntilDestroyed(this._destroyRef), tap(v => {
             const waitForPreparation = this.waitForPreparation();
             readyToStart = v;
             this.classes.set({ prepared: true, [READY_TO_START]: true, [WAIT_FOR_PREPARATION]: waitForPreparation });
+            this.updateImmediately();
         })).subscribe();
         this._service.$focusedId.pipe(takeUntilDestroyed(), tap(v => {
             this.focusedElement.set(v ?? undefined);
@@ -4907,8 +4918,7 @@ class NgVirtualListComponent {
                             snap: this.snap(), fromItemId: id, enabledBufferOptimization: this.enabledBufferOptimization(),
                         }, scrollSize = this._trackBox.getItemPosition(id, itemConfigMap, opts), params = {
                             [isVertical ? TOP_PROP_NAME : LEFT_PROP_NAME]: scrollSize, behavior: BEHAVIOR_INSTANT,
-                            fireUpdate: false,
-                            blending: true,
+                            fireUpdate: false, blending: false,
                         };
                         if (scrollSize === -1) {
                             return of([true, { id, scroller: scrollerComponent, scrollCalled, cb }]);
@@ -4951,7 +4961,7 @@ class NgVirtualListComponent {
                                 _$scrollToEndDuringUpdateCanceller.next(1);
                                 const params = {
                                     [this._isVertical ? TOP_PROP_NAME : LEFT_PROP_NAME]: scrollSize,
-                                    behavior: BEHAVIOR_INSTANT, blending: true,
+                                    behavior: BEHAVIOR_INSTANT, blending: false,
                                 };
                                 scrollerComponent?.scrollTo?.(params);
                                 return of([true, { id, scroller: scrollerComponent, cb }]).pipe(delay(1));
@@ -5191,6 +5201,9 @@ class NgVirtualListComponent {
             this._trackBox.changes();
         }
     }
+    /**
+     * Force clearing the cache.
+     */
     cacheClean() {
         this._trackBox.cacheClean();
         this._collapsedItemIds.set([]);
@@ -5204,6 +5217,9 @@ class NgVirtualListComponent {
         }
         this._$prepared.next(false);
     }
+    /**
+     * Stops the list from snapping to the bottom edge.
+     */
     stopSnappingScrollToEnd() {
         const scroller = this._scrollerComponent();
         this._isScrollFinished.set(false);
@@ -5212,6 +5228,18 @@ class NgVirtualListComponent {
             scroller.stopScrolling();
         }
     }
+    /**
+     * Instantly refreshes the list.
+     */
+    updateImmediately() {
+        this._service.update(true);
+    }
+    /**
+     * Marks the list for an update that will trigger on the next tick.
+     */
+    markForUpdate() {
+        this._service.update();
+    }
     ngOnDestroy() {
         this.dispose();
     }