fix(infinite-scroll): awaiting for DOM writes before firing infinite scroll event

Author: ShaneK

core/api.txt

@@ -919,6 +919,7 @@ ion-infinite-scroll,none
 ion-infinite-scroll,prop,disabled,boolean,false,false,false
 ion-infinite-scroll,prop,mode,"ios" | "md",undefined,false,false
 ion-infinite-scroll,prop,position,"bottom" | "top",'bottom',false,false
+ion-infinite-scroll,prop,preserveRerenderScrollPosition,boolean,false,false,false
 ion-infinite-scroll,prop,theme,"ios" | "md" | "ionic",undefined,false,false
 ion-infinite-scroll,prop,threshold,string,'15%',false,false
 ion-infinite-scroll,method,complete,complete() => Promise<void>

core/src/components/infinite-scroll/infinite-scroll.tsx

@@ -85,7 +85,6 @@ export class InfiniteScroll implements ComponentInterface {
    * If `true`, the infinite scroll will preserve the scroll position
    * when the content is re-rendered. This is useful when the content is
    * re-rendered with new keys, and the scroll position should be preserved.
-   * @internal
    */
   @Prop() preserveRerenderScrollPosition: boolean = false;
 
@@ -143,15 +142,18 @@ export class InfiniteScroll implements ComponentInterface {
 
     if (distanceFromInfinite < 0) {
       if (!this.didFire) {
+        this.isLoading = true;
+        this.didFire = true;
+
         if (this.preserveRerenderScrollPosition) {
           // Lock the min height of the siblings of the infinite scroll
           // if we are preserving the rerender scroll position
-          this.lockSiblingMinHeight(true);
+          this.lockSiblingMinHeight(true).then(() => {
+            this.ionInfinite.emit();
+          });
+        } else {
+          this.ionInfinite.emit();
         }
-
-        this.isLoading = true;
-        this.didFire = true;
-        this.ionInfinite.emit();
         return 3;
       }
     }
@@ -168,32 +170,44 @@ export class InfiniteScroll implements ComponentInterface {
    * We preserve existing min-height values, if they're set, so we don't erase what
    * has been previously set by the user when we restore after complete is called.
    */
-  private lockSiblingMinHeight(lock: boolean) {
-    const siblings = this.el.parentElement?.children || [];
-    for (const sibling of siblings) {
-      // Loop through all the siblings of the infinite scroll, but ignore ourself
-      if (sibling !== this.el && sibling instanceof HTMLElement) {
-        if (lock) {
-          const elementHeight = sibling.getBoundingClientRect().height;
-          if (this.minHeightLocked) {
-            // The previous min height is from us locking it before, so we can disregard it
-            // We still need to lock the min height if we're already locked, though, because
-            // the user could have triggered a new load before we've finished the previous one.
-            const previousMinHeight = sibling.style.minHeight;
-            if (previousMinHeight) {
-              sibling.style.setProperty('--ion-previous-min-height', previousMinHeight);
-            }
+  private lockSiblingMinHeight(lock: boolean): Promise<void> {
+    return new Promise((resolve) => {
+      const siblings = this.el.parentElement?.children || [];
+      const writes: (() => void)[] = [];
+
+      for (const sibling of siblings) {
+        // Loop through all the siblings of the infinite scroll, but ignore ourself
+        if (sibling !== this.el && sibling instanceof HTMLElement) {
+          if (lock) {
+            const elementHeight = sibling.getBoundingClientRect().height;
+            writes.push(() => {
+              if (this.minHeightLocked) {
+                // The previous min height is from us locking it before, so we can disregard it
+                // We still need to lock the min height if we're already locked, though, because
+                // the user could have triggered a new load before we've finished the previous one.
+                const previousMinHeight = sibling.style.minHeight;
+                if (previousMinHeight) {
+                  sibling.style.setProperty('--ion-previous-min-height', previousMinHeight);
+                }
+              }
+              sibling.style.minHeight = `${elementHeight}px`;
+            });
+          } else {
+            writes.push(() => {
+              const previousMinHeight = sibling.style.getPropertyValue('--ion-previous-min-height');
+              sibling.style.minHeight = previousMinHeight || 'auto';
+              sibling.style.removeProperty('--ion-previous-min-height');
+            });
           }
-          sibling.style.minHeight = `${elementHeight}px`;
-        } else {
-          const previousMinHeight = sibling.style.getPropertyValue('--ion-previous-min-height');
-          sibling.style.minHeight = previousMinHeight || 'auto';
-          sibling.style.removeProperty('--ion-previous-min-height');
         }
       }
-    }
 
-    this.minHeightLocked = lock;
+      writeTask(() => {
+        writes.forEach((w) => w());
+        this.minHeightLocked = lock;
+        resolve();
+      });
+    });
   }
 
   /**
@@ -264,8 +278,8 @@ export class InfiniteScroll implements ComponentInterface {
     // Unlock the min height of the siblings of the infinite scroll
     // if we are preserving the rerender scroll position
     if (this.preserveRerenderScrollPosition) {
-      setTimeout(() => {
-        this.lockSiblingMinHeight(false);
+      setTimeout(async () => {
+        await this.lockSiblingMinHeight(false);
       }, 100);
     }
   }

core/src/components/infinite-scroll/test/preserve-rerender-scroll-position/index.html

@@ -67,7 +67,6 @@
         }
         loading = true;
 
-        await wait(300);
         replaceAllItems();
         infiniteScroll.complete();
 
@@ -99,7 +98,7 @@
 
         // Add new items with new "keys" (different content/identifiers)
         // Start with more items to ensure scrollable content
-        const totalItems = generation === 1 ? 30 : 30 + generation * 20;
+        const totalItems = generation === 1 ? 50 : 30 + generation * 20;
         itemCount = 0;
 
         for (let i = 0; i < totalItems; i++) {

core/src/components/infinite-scroll/test/preserve-rerender-scroll-position/infinite-scroll.e2e.ts

@@ -12,10 +12,10 @@ configs({ modes: ['md'], directions: ['ltr'] }).forEach(({ title, config }) => {
       const content = page.locator('ion-content');
       const items = page.locator('ion-item');
       const innerScroll = page.locator('.inner-scroll');
-      expect(await items.count()).toBe(30);
+      expect(await items.count()).toBe(50);
 
       let previousScrollTop = 0;
-      for (let i = 0; i < 20; i++) {
+      for (let i = 0; i < 30; i++) {
         await content.evaluate((el: HTMLIonContentElement) => el.scrollToBottom(0));
         const currentScrollTop = await innerScroll.evaluate((el: HTMLIonContentElement) => el.scrollTop);
         expect(currentScrollTop).toBeGreaterThan(previousScrollTop);
@@ -26,13 +26,6 @@ configs({ modes: ['md'], directions: ['ltr'] }).forEach(({ title, config }) => {
           previousScrollTop
         );
         previousScrollTop = currentScrollTop;
-
-        // Timeout to allow the browser to catch up.
-        // For some reason, without this, the scroll top gets reset to 0. Adding this
-        // prevents that, which implies it's an issue with Playwright, not the feature.
-        // For some reason, this delay needs to be longer than the time required to
-        // reset the minimum height in infinite scroll.
-        await new Promise((resolve) => setTimeout(resolve, 1001));
       }
     });
   });

packages/angular/src/directives/proxies.ts

@@ -927,15 +927,15 @@ export declare interface IonImg extends Components.IonImg {
 
 
 @ProxyCmp({
-  inputs: ['disabled', 'mode', 'position', 'theme', 'threshold'],
+  inputs: ['disabled', 'mode', 'position', 'preserveRerenderScrollPosition', 'theme', 'threshold'],
   methods: ['complete']
 })
 @Component({
   selector: 'ion-infinite-scroll',
   changeDetection: ChangeDetectionStrategy.OnPush,
   template: '<ng-content></ng-content>',
   // eslint-disable-next-line @angular-eslint/no-inputs-metadata-property
-  inputs: ['disabled', 'mode', 'position', 'theme', 'threshold'],
+  inputs: ['disabled', 'mode', 'position', 'preserveRerenderScrollPosition', 'theme', 'threshold'],
 })
 export class IonInfiniteScroll {
   protected el: HTMLIonInfiniteScrollElement;

packages/angular/standalone/src/directives/proxies.ts

@@ -952,15 +952,15 @@ export declare interface IonImg extends Components.IonImg {
 
 @ProxyCmp({
   defineCustomElementFn: defineIonInfiniteScroll,
-  inputs: ['disabled', 'mode', 'position', 'theme', 'threshold'],
+  inputs: ['disabled', 'mode', 'position', 'preserveRerenderScrollPosition', 'theme', 'threshold'],
   methods: ['complete']
 })
 @Component({
   selector: 'ion-infinite-scroll',
   changeDetection: ChangeDetectionStrategy.OnPush,
   template: '<ng-content></ng-content>',
   // eslint-disable-next-line @angular-eslint/no-inputs-metadata-property
-  inputs: ['disabled', 'mode', 'position', 'theme', 'threshold'],
+  inputs: ['disabled', 'mode', 'position', 'preserveRerenderScrollPosition', 'theme', 'threshold'],
   standalone: true
 })
 export class IonInfiniteScroll {