react · Abbondanzo · Sep 28, 2026 · Sep 28, 2026
diff --git a/packages/react-native/Libraries/Components/Button.js b/packages/react-native/Libraries/Components/Button.js
@@ -56,16 +56,6 @@ type ButtonPropsCore = Readonly<{
    */
   color?: ?ColorValue,
 
-  /**
-   * TV preferred focus.
-   *
-   * @platform tv
-   *
-   * @default `false`
-   * @deprecated Use `focusable` instead
-   */
-  hasTVPreferredFocus?: ?boolean,
-
   /**
    * Designates the next view to receive focus when the user navigates down. See
    * the [Android documentation][android:nextFocusDown].
@@ -219,7 +209,6 @@ const Button: component(
     onPress,
     touchSoundDisabled,
     title,
-    hasTVPreferredFocus,
     nextFocusDown,
     nextFocusForward,
     nextFocusLeft,
@@ -290,7 +279,6 @@ const Button: component(
       accessibilityRole="button"
       accessibilityState={_accessibilityState}
       importantForAccessibility={_importantForAccessibility}
-      hasTVPreferredFocus={hasTVPreferredFocus}
       nextFocusDown={nextFocusDown}
       nextFocusForward={nextFocusForward}
       nextFocusLeft={nextFocusLeft}

diff --git a/packages/react-native/Libraries/Components/Touchable/TouchableHighlight.js b/packages/react-native/Libraries/Components/Touchable/TouchableHighlight.js
@@ -34,13 +34,6 @@ type AndroidProps = Readonly<{
   nextFocusUp?: ?number,
 }>;
 
-type IOSProps = Readonly<{
-  /**
-   * @deprecated Use `focusable` instead
-   */
-  hasTVPreferredFocus?: ?boolean,
-}>;
-
 type TouchableHighlightBaseProps = Readonly<{
   /**
    * Opacity of the wrapped view when touch is active. Requires `underlayColor` to be set.
@@ -75,7 +68,6 @@ type TouchableHighlightBaseProps = Readonly<{
 export type TouchableHighlightProps = Readonly<{
   ...TouchableWithoutFeedbackProps,
   ...AndroidProps,
-  ...IOSProps,
   ...TouchableHighlightBaseProps,
 }>;
 
@@ -281,7 +273,6 @@ class TouchableHighlightImpl extends React.Component<
         )}
         onLayout={this.props.onLayout}
         hitSlop={this.props.hitSlop}
-        hasTVPreferredFocus={this.props.hasTVPreferredFocus}
         nextFocusDown={this.props.nextFocusDown}
         nextFocusForward={this.props.nextFocusForward}
         nextFocusLeft={this.props.nextFocusLeft}

diff --git a/packages/react-native/Libraries/Components/Touchable/TouchableNativeFeedback.js b/packages/react-native/Libraries/Components/Touchable/TouchableNativeFeedback.js
@@ -26,14 +26,6 @@ import * as React from 'react';
 import {cloneElement} from 'react';
 
 type TouchableNativeFeedbackTVProps = {
-  /**
-   * *(Apple TV only)* TV preferred focus (see documentation for the View component).
-   *
-   * @platform ios
-   * @deprecated Use `focusable` instead
-   */
-  hasTVPreferredFocus?: ?boolean,
-
   /**
    * Designates the next view to receive focus when the user navigates down. See the Android documentation.
    *
@@ -345,7 +337,6 @@ class TouchableNativeFeedback extends React.Component<
         accessibilityLiveRegion: accessibilityLiveRegion,
         accessibilityElementsHidden:
           this.props['aria-hidden'] ?? this.props.accessibilityElementsHidden,
-        hasTVPreferredFocus: this.props.hasTVPreferredFocus,
         hitSlop: this.props.hitSlop,
         focusable:
           this.props.focusable !== false &&

diff --git a/packages/react-native/Libraries/Components/Touchable/TouchableOpacity.js b/packages/react-native/Libraries/Components/Touchable/TouchableOpacity.js
@@ -25,14 +25,6 @@ import * as React from 'react';
 export type TouchableOpacityInstance = HostInstance;
 
 export type TouchableOpacityTVProps = Readonly<{
-  /**
-   * *(Apple TV only)* TV preferred focus (see documentation for the View component).
-   *
-   * @platform ios
-   * @deprecated Use `focusable` instead
-   */
-  hasTVPreferredFocus?: ?boolean,
-
   /**
    * Designates the next view to receive focus when the user navigates down. See the Android documentation.
    *
@@ -261,7 +253,6 @@ class TouchableOpacity extends React.Component<
         nextFocusLeft={this.props.nextFocusLeft}
         nextFocusRight={this.props.nextFocusRight}
         nextFocusUp={this.props.nextFocusUp}
-        hasTVPreferredFocus={this.props.hasTVPreferredFocus}
         hitSlop={this.props.hitSlop}
         focusable={
           this.props.focusable !== false &&

diff --git a/packages/react-native/Libraries/Components/View/ViewPropTypes.js b/packages/react-native/Libraries/Components/View/ViewPropTypes.js
@@ -305,14 +305,6 @@ export type ViewPropsAndroid = Readonly<{
    */
   renderToHardwareTextureAndroid?: ?boolean,
 
-  /**
-   * Whether to force the Android TV focus engine to move focus to this view.
-   *
-   * @platform android
-   * @deprecated Use `focusable` instead
-   */
-  hasTVPreferredFocus?: ?boolean,
-
   /**
    * Designates the next view to receive focus when the user navigates down.
    * The value is the `nativeID` of the target view.
@@ -390,14 +382,6 @@ export type TVViewPropsIOS = Readonly<{
    */
   isTVSelectable?: boolean,
 
-  /**
-   * *(Apple TV only)* May be set to true to force the Apple TV focus engine to move focus to this view.
-   *
-   * @platform ios
-   * @deprecated Use `focusable` instead
-   */
-  hasTVPreferredFocus?: boolean,
-
   /**
    * *(Apple TV only)* May be used to change the appearance of the Apple TV parallax effect when this view goes in or out of focus.  Defaults to 2.0.
    *

diff --git a/packages/react-native/Libraries/Components/View/__tests__/View-benchmark-itest.js b/packages/react-native/Libraries/Components/View/__tests__/View-benchmark-itest.js
@@ -53,7 +53,6 @@ function createViewsWithLargeAmountOfPropsAndStyles(count: number): React.Node {
         aria-live={'polite'}
         collapsable={false}
         focusable={i % 2 === 0}
-        hasTVPreferredFocus={i % 2 === 0}
         id={String(i)}
         importantForAccessibility={'no-hide-descendants'}
         nativeID={String(i)}

diff --git a/packages/react-native/Libraries/Components/View/__tests__/ViewProps-benchmark-itest.js b/packages/react-native/Libraries/Components/View/__tests__/ViewProps-benchmark-itest.js
@@ -36,7 +36,6 @@ function buildViewsWithFullPropBag(
         aria-live="polite"
         collapsable={false}
         focusable={i % 2 === 0}
-        hasTVPreferredFocus={i % 2 === 0}
         id={String(i)}
         importantForAccessibility="no-hide-descendants"
         nativeID={String(i)}

diff --git a/packages/react-native/Libraries/NativeComponent/BaseViewConfig.android.js b/packages/react-native/Libraries/NativeComponent/BaseViewConfig.android.js
@@ -360,7 +360,6 @@ const validAttributesForNonEventProps = {
 
   // ReactViewManager @ReactProps
   accessible: true,
-  hasTVPreferredFocus: true,
   nextFocusDown: true,
   nextFocusForward: true,
   nextFocusLeft: true,

diff --git a/...react-native/ReactAndroid/src/main/java/com/facebook/react/views/view/ReactViewManager.kt b/...react-native/ReactAndroid/src/main/java/com/facebook/react/views/view/ReactViewManager.kt
@@ -124,14 +124,16 @@ public open class ReactViewManager : ReactClippingViewManager<ReactViewGroup>()
     view.axOrderList = axOrderList
   }
 
-  @ReactProp(name = "hasTVPreferredFocus")
-  public open fun setTVPreferredFocus(view: ReactViewGroup, hasTVPreferredFocus: Boolean) {
-    if (hasTVPreferredFocus) {
-      view.isFocusable = true
-      view.isFocusableInTouchMode = true
-      view.requestFocus()
-    }
-  }
+  /**
+   * Retained for binary compatibility with [ReactViewManager] subclasses.
+   *
+   * This method no longer registers a React prop or changes view focus.
+   */
+  @Deprecated("Use focusable or focus() instead")
+  public open fun setTVPreferredFocus(
+      view: ReactViewGroup,
+      hasTVPreferredFocus: Boolean,
+  ): Unit = Unit
 
   @ReactProp(name = ViewProps.BACKGROUND_IMAGE, customType = "BackgroundImage")
   public open fun setBackgroundImage(view: ReactViewGroup, backgroundImage: ReadableArray?) {

diff --git a/packages/react-native/ReactAndroid/src/main/jni/react/fabric/FocusOrderingHelper.cpp b/packages/react-native/ReactAndroid/src/main/jni/react/fabric/FocusOrderingHelper.cpp
@@ -207,8 +207,7 @@ void FocusOrderingHelper::traverseAndUpdateNextFocusableElement(
   // We only care about focusable elements since only they can be both
   // focused and present in the hierarchy
   if (currNode->getTraits().check(ShadowNodeTraits::Trait::KeyboardFocusable) ||
-      (props != nullptr &&
-       (props->focusable || props->accessible || props->hasTVPreferredFocus))) {
+      (props != nullptr && (props->focusable || props->accessible))) {
     LayoutMetrics nodeLayoutMetrics = uimanager.getRelativeLayoutMetrics(
         *currNode, parentShadowNode.get(), {.includeTransform = true});
 

diff --git a/...components/view/platform/android/react/renderer/components/view/HostPlatformViewProps.cpp b/...components/view/platform/android/react/renderer/components/view/HostPlatformViewProps.cpp
@@ -48,12 +48,6 @@ HostPlatformViewProps::HostPlatformViewProps(
           "focusable",
           sourceProps.focusable,
           {})),
-      hasTVPreferredFocus(convertRawProp(
-          context,
-          rawProps,
-          "hasTVPreferredFocus",
-          sourceProps.hasTVPreferredFocus,
-          {})),
       needsOffscreenAlphaCompositing(convertRawProp(
           context,
           rawProps,
@@ -120,7 +114,6 @@ void HostPlatformViewProps::setProp(
     RAW_SET_PROP_SWITCH_CASE(nativeBackground, "nativeBackgroundAndroid");
     RAW_SET_PROP_SWITCH_CASE(nativeForeground, "nativeForegroundAndroid");
     RAW_SET_PROP_SWITCH_CASE_BASIC(focusable);
-    RAW_SET_PROP_SWITCH_CASE_BASIC(hasTVPreferredFocus);
     RAW_SET_PROP_SWITCH_CASE_BASIC(needsOffscreenAlphaCompositing);
     RAW_SET_PROP_SWITCH_CASE_BASIC(renderToHardwareTextureAndroid);
     RAW_SET_PROP_SWITCH_CASE_BASIC(screenReaderFocusable);
@@ -482,10 +475,6 @@ folly::dynamic HostPlatformViewProps::getDiffProps(
     result["focusable"] = focusable;
   }
 
-  if (hasTVPreferredFocus != oldProps->hasTVPreferredFocus) {
-    result["hasTVPreferredFocus"] = hasTVPreferredFocus;
-  }
-
   if (needsOffscreenAlphaCompositing !=
       oldProps->needsOffscreenAlphaCompositing) {
     result["needsOffscreenAlphaCompositing"] = needsOffscreenAlphaCompositing;

diff --git a/...r/components/view/platform/android/react/renderer/components/view/HostPlatformViewProps.h b/...r/components/view/platform/android/react/renderer/components/view/HostPlatformViewProps.h
@@ -42,7 +42,6 @@ class HostPlatformViewProps : public BaseViewProps {
   std::optional<NativeDrawable> nativeForeground{};
 
   bool focusable{false};
-  bool hasTVPreferredFocus{false};
   bool needsOffscreenAlphaCompositing{false};
   bool renderToHardwareTextureAndroid{false};
   bool screenReaderFocusable{false};

diff --git a/.../view/platform/android/react/renderer/components/view/HostPlatformViewTraitsInitializer.h b/.../view/platform/android/react/renderer/components/view/HostPlatformViewTraitsInitializer.h
@@ -22,13 +22,13 @@ inline bool formsStackingContext(const ViewProps &viewProps)
 inline bool formsView(const ViewProps &viewProps)
 {
   return viewProps.nativeBackground.has_value() || viewProps.nativeForeground.has_value() || viewProps.focusable ||
-      viewProps.hasTVPreferredFocus || viewProps.needsOffscreenAlphaCompositing ||
-      viewProps.renderToHardwareTextureAndroid || viewProps.screenReaderFocusable;
+      viewProps.needsOffscreenAlphaCompositing || viewProps.renderToHardwareTextureAndroid ||
+      viewProps.screenReaderFocusable;
 }
 
 inline bool isKeyboardFocusable(const ViewProps &viewProps)
 {
-  return (viewProps.focusable || viewProps.hasTVPreferredFocus);
+  return viewProps.focusable;
 }
 
 } // namespace facebook::react::HostPlatformViewTraitsInitializer