docs

Author: mdjastrzebski

packages/react-native/Libraries/Components/Pressable/Pressable.js

@@ -120,8 +120,10 @@ type PressableBaseProps = Readonly<{
   onPressOut?: ?(event: GestureResponderEvent) => unknown,
 
   /**
-   * Whether to prevent any other native components from becoming responder
-   * while this pressable is responder.
+   * When true, prevents native ancestor views (UIKit responder chain) from
+   * receiving touch events when this Pressable handles a press.
+   *
+   * @platform ios
    */
   preventNativePropagation?: ?boolean,
 

packages/react-native/Libraries/Components/View/ViewPropTypes.js

@@ -504,8 +504,12 @@ type ViewBaseProps = Readonly<{
 
   /**
    * When true, prevents native ancestor views (UIKit responder chain) from
-   * receiving touch events when this view is the active JS responder.
-   * Requires that the Fabric gesture recognizer has already claimed the touch.
+   * receiving touch events when this view handles a press. Without this, UIKit
+   * delivers touches independently to every view that received touchesBegan:,
+   * so parent views fire touchesEnded: even when a child Pressable handles the
+   * press.
+   *
+   * @platform ios
    */
   preventNativePropagation?: ?boolean,
 

packages/react-native/Libraries/Pressability/Pressability.js

@@ -131,8 +131,8 @@ export type PressabilityConfig = Readonly<{
   onPressOut?: ?(event: GestureResponderEvent) => unknown,
 
   /**
-   * Whether to prevent any other native components from becoming responder
-   * while this pressable is responder.
+   * When true, prevents native ancestor views (UIKit responder chain) from
+   * receiving touch events when this Pressable handles a press. iOS only.
    */
   preventNativePropagation?: ?boolean,
 }>;

packages/react-native/ReactCommon/react/renderer/components/view/BaseViewProps.h

@@ -108,7 +108,7 @@ class BaseViewProps : public YogaStylableProps, public AccessibilityProps {
   bool collapsableChildren{true};
 
   bool removeClippedSubviews{false};
-  bool preventNativePropagation{false};
+  bool preventNativePropagation{false}; // iOS only
 
 #pragma mark - Convenience Methods