From f6c9a855ae7dd80f375611bbfe2ad6583d1c4c40 Mon Sep 17 00:00:00 2001 From: Kirill Zyusko Date: Wed, 4 Nov 2026 13:54:33 +0100 Subject: [PATCH] [iOS] Reset ScrollView frame when recycling MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Summary: An interactive native-stack swipe-back with keyboard dismissal and native-driven `Animated` height updates can leave the internal `UIScrollView` with a negative frame origin. `prepareForRecycle` resets the outer component's frame, but retains the inner view's geometry. Reopening the screen reuses that offset view, shifting its content upward and leaving a gap at the bottom. Reset `_scrollView.frame` to `self.bounds` at the end of `prepareForRecycle`. > [!WARNING] > To reproduce this problem I had to use new experimental shared Animated backend + drive `height` updates. And also use native-stack. I didn't find a way to reproduce it without `react-native-screens`/`native-stack`, but I strongly believe that root cause lives in `react-native` core. [Minimal runnable reproduction](https://github.com/kirillzyusko/react-native-scrollview-recycling-repro/tree/f77137dceb5d2190278aec7400e5bcedf4a676db) | [App.js code](https://github.com/kirillzyusko/react-native-scrollview-recycling-repro/blob/f77137dceb5d2190278aec7400e5bcedf4a676db/App.js) | [Reproduction changes](https://github.com/kirillzyusko/react-native-scrollview-recycling-repro/commit/f77137dceb5d2190278aec7400e5bcedf4a676db) The repro uses React Native Animated, native-stack, screens and safe-area-context. It has no Reanimated, Worklets or keyboard-controller dependency (though original problem was discovered with `react-native-keyboard-controller` ([#1200](https://github.com/kirillzyusko/react-native-keyboard-controller/issues/1200)) /`react-native-reanimated`/`react-native-worklets` - in this PR I tried to isolate changes as close to bare RN as possible, but I still had to use `react-native-screens` for native navigation with gestures and all that stuff. Without navigation I didn't find a way to reproduce this problem - but repro confirms that it's not reanimated/keyboard-controlelr specific issue). The public Experimental release preset enables the shared Animated backend and C++ Native Animated. Related report: [react-native-keyboard-controller#1200](https://github.com/kirillzyusko/react-native-keyboard-controller/issues/1200). ## Changelog: [IOS] [FIXED] - Reset the inner ScrollView frame when recycling to prevent a stale offset on reuse. ## Test Plan: Verified using **iPhone 16 Pro Simulator (iOS 18.5)**, Xcode 27.0, **React Native 0.87.1 / Fabric**. ### Reproduction At the pinned reproduction commit: ```sh yarn bundle install cd ios && bundle exec pod install && cd .. yarn start # In another terminal: yarn ios --simulator "iPhone 16 Pro" ``` Enable the simulator's software keyboard. The interpolation constants target this device's 402 × 874 pt screen. 1. Freshly launch the app. 2. Press **Open ScrollView**. 3. Focus **Type a message** and wait for the keyboard. 4. Press **Scroll to end**. 5. Swipe back from the left phone bezel, with the keyboard initially open. 6. Press **Open ScrollView** again. > [!IMPORTANT] > The first opening maps native `onScroll` events to height using `Animated.event` with `useNativeDriver: true`. Keyboard dismissal triggers a second resize after 100 ms. > >⚠️ The second opening uses a static height to expose the recycled geometry. Then run `yarn apply-fix`, rebuild with `yarn ios --simulator "iPhone 16 Pro"`, and repeat the same steps. ### Results | After reopening | Before | After | | --- | --- | --- | | Inner ScrollView frame.y | −128.6667 pt | 0 pt | | Same native inner and outer views reused | Yes | Yes | | React tag changes on reuse | 218 -> 426 | 218 -> 426 | | Yellow gap below content | Visible | Absent | ### Screenshots — iPhone 16 Pro Simulator, iOS 18.5 | Before | After | | --- | --- | | ![Before — iPhone 16 Pro Simulator, iOS 18.5](https://raw.githubusercontent.com/kirillzyusko/react-native-scrollview-recycling-repro/f77137dceb5d2190278aec7400e5bcedf4a676db/evidence/before.png) | ![After — iPhone 16 Pro Simulator, iOS 18.5](https://raw.githubusercontent.com/kirillzyusko/react-native-scrollview-recycling-repro/f77137dceb5d2190278aec7400e5bcedf4a676db/evidence/after-english.png) | ### Videos — iPhone 16 Pro Simulator, iOS 18.5 | Before | After | | --- | --- | | | | Differential Revision: D129585510 Pull Request resolved: https://github.com/react/react-native/pull/59362 --- .../ComponentViews/ScrollView/RCTScrollViewComponentView.mm | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/react-native/React/Fabric/Mounting/ComponentViews/ScrollView/RCTScrollViewComponentView.mm b/packages/react-native/React/Fabric/Mounting/ComponentViews/ScrollView/RCTScrollViewComponentView.mm index 1913a99d79b..8efc837a8d6 100644 --- a/packages/react-native/React/Fabric/Mounting/ComponentViews/ScrollView/RCTScrollViewComponentView.mm +++ b/packages/react-native/React/Fabric/Mounting/ComponentViews/ScrollView/RCTScrollViewComponentView.mm @@ -725,6 +725,7 @@ static inline UIViewAnimationOptions animationOptionsWithCurve(UIViewAnimationCu _firstVisibleView = nil; _firstVisibleViewTag = 0; _virtualViewContainerState = nil; + _scrollView.frame = self.bounds; } #pragma mark - UIScrollViewDelegate