mirror of
https://github.com/facebook/react-native.git
synced 2025-11-01 09:14:26 +00:00
Peter Abbondanzo
cfb6c968dd
Summary: Pull Request resolved: https://github.com/facebook/react-native/pull/52043 The `hasTVPreferredFocus` prop is functionally similar to the `focusable` prop. On iOS, the props are identical. The primary difference appears on Android, where the prop attempts to request focus when set to true. Attempting to invoke imperative API calls through declarative means has been [a source of confusion](https://github.com/react-native-tvos/react-native-tvos/issues/237) and we should instead recommend requesting focus through imperative means, like calling `focus()` on a specific view's ref instead. Workarounds presented rely on lifecycle methods to request focus natively. This change only marks these methods as deprecated on JS. In the following version, they will be removed from the public API. Changelog: [General][Deprecated] - Deprecate `hasTVPreferredFocus` Reviewed By: andrewdacenko Differential Revision: D76732539 fbshipit-source-id: 64912b4dacb76cd40e79148c1082d8ed8f573879
83 lines
2.3 KiB
TypeScript
83 lines
2.3 KiB
TypeScript
/**
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*
|
|
* @format
|
|
*/
|
|
|
|
import type * as React from 'react';
|
|
import {View} from '../../Components/View/View';
|
|
import {TouchableWithoutFeedbackProps} from './TouchableWithoutFeedback';
|
|
|
|
export interface TVProps {
|
|
/**
|
|
* *(Apple TV only)* TV preferred focus (see documentation for the View component).
|
|
*
|
|
* @platform ios
|
|
* @deprecated Use `focusable` instead
|
|
*/
|
|
hasTVPreferredFocus?: boolean | undefined;
|
|
|
|
/**
|
|
* Designates the next view to receive focus when the user navigates down. See the Android documentation.
|
|
*
|
|
* @platform android
|
|
*/
|
|
nextFocusDown?: number | undefined;
|
|
|
|
/**
|
|
* Designates the next view to receive focus when the user navigates forward. See the Android documentation.
|
|
*
|
|
* @platform android
|
|
*/
|
|
nextFocusForward?: number | undefined;
|
|
|
|
/**
|
|
* Designates the next view to receive focus when the user navigates left. See the Android documentation.
|
|
*
|
|
* @platform android
|
|
*/
|
|
nextFocusLeft?: number | undefined;
|
|
|
|
/**
|
|
* Designates the next view to receive focus when the user navigates right. See the Android documentation.
|
|
*
|
|
* @platform android
|
|
*/
|
|
nextFocusRight?: number | undefined;
|
|
|
|
/**
|
|
* Designates the next view to receive focus when the user navigates up. See the Android documentation.
|
|
*
|
|
* @platform android
|
|
*/
|
|
nextFocusUp?: number | undefined;
|
|
}
|
|
|
|
/**
|
|
* @see https://reactnative.dev/docs/touchableopacity#props
|
|
*/
|
|
export interface TouchableOpacityProps
|
|
extends TouchableWithoutFeedbackProps,
|
|
TVProps {
|
|
/**
|
|
* Determines what the opacity of the wrapped view should be when touch is active.
|
|
* Defaults to 0.2
|
|
*/
|
|
activeOpacity?: number | undefined;
|
|
}
|
|
|
|
/**
|
|
* A wrapper for making views respond properly to touches.
|
|
* On press down, the opacity of the wrapped view is decreased, dimming it.
|
|
* This is done without actually changing the view hierarchy,
|
|
* and in general is easy to add to an app without weird side-effects.
|
|
*
|
|
* @see https://reactnative.dev/docs/touchableopacity
|
|
*/
|
|
export const TouchableOpacity: React.ForwardRefExoticComponent<
|
|
React.PropsWithoutRef<TouchableOpacityProps> & React.RefAttributes<View>
|
|
>;
|