Saltar al contenido principal
Versión: 0.82

TouchableNativeFeedback

Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

consejo

Si buscas una forma más completa y preparada para el futuro de manejar entradas táctiles, revisa la API Pressable.

Un contenedor para hacer que las vistas respondan correctamente a toques (solo Android). En Android, este componente utiliza un drawable de estado nativo para mostrar retroalimentación táctil.

Actualmente solo admite tener una única instancia de View como nodo hijo, ya que se implementa reemplazando esa View con otra instancia de nodo RCTView con propiedades adicionales configuradas.

El drawable de fondo del elemento táctil de retroalimentación nativa se puede personalizar con la propiedad background.

Ejemplo


Referencia

Props

Propiedades de TouchableWithoutFeedback

Hereda las propiedades de TouchableWithoutFeedback.


background

Determina el tipo de drawable de fondo que se usará para mostrar retroalimentación. Recibe un objeto con propiedad type y datos adicionales según el type. Se recomienda usar uno de los métodos estáticos para generar ese diccionario.

Type
backgroundPropType

useForeground

Configúralo como true para agregar el efecto de ripple en primer plano de la vista, en lugar del fondo. Esto es útil si una vista hija tiene su propio fondo, o estás mostrando imágenes por ejemplo, y no quieres que el ripple quede cubierto.

Verifica primero TouchableNativeFeedback.canUseNativeForeground(), ya que esto solo está disponible en Android 6.0 y superior. Si intentas usarlo en versiones anteriores, obtendrás una advertencia y se recurrirá al fondo.

Type
bool

hasTVPreferredFocus
Android

Enfoque preferido de TV (ver documentación del componente View).

Type
bool

nextFocusDown
Android

Siguiente enfoque hacia abajo en TV (ver documentación del componente View).

Type
number

nextFocusForward
Android

Siguiente enfoque hacia adelante en TV (ver documentación del componente View).

Type
number

nextFocusLeft
Android

Siguiente enfoque izquierdo en TV (ver documentación del componente View).

Type
number

nextFocusRight
Android

Siguiente enfoque derecho en TV (ver documentación del componente View).

Type
number

nextFocusUp
Android

Siguiente enfoque hacia arriba en TV (ver documentación del componente View).

Type
number

Métodos

SelectableBackground()

tsx
static SelectableBackground(
rippleRadius: number | null,
): ThemeAttributeBackgroundPropType;

Crea un objeto que representa el fondo predeterminado del tema de Android para elementos seleccionables (?android:attr/selectableItemBackground). El parámetro rippleRadius controla el radio del efecto ripple.


SelectableBackgroundBorderless()

tsx
static SelectableBackgroundBorderless(
rippleRadius: number | null,
): ThemeAttributeBackgroundPropType;

Crea un objeto que representa el fondo predeterminado del tema de Android para elementos seleccionables sin bordes (?android:attr/selectableItemBackgroundBorderless). Disponible en Android API nivel 21+. El parámetro rippleRadius controla el radio del efecto ripple.


Ripple()

tsx
static Ripple(
color: ColorValue,
borderless: boolean,
rippleRadius?: number | null,
): RippleBackgroundPropType;

Crea un objeto que representa un drawable ripple con color especificado (como cadena). Si la propiedad borderless es true, el ripple se renderizará fuera de los límites de la vista (ver botones de actionbar nativos como ejemplo de ese comportamiento). Este tipo de fondo está disponible en Android API nivel 21+.

Parámetros:

NameTypeRequiredDescription
colorstringYesThe ripple color
borderlessbooleanYesIf the ripple can render outside its bounds
rippleRadius?numberNocontrols the radius of the ripple effect

canUseNativeForeground()

tsx
static canUseNativeForeground(): boolean;