TouchableNativeFeedback

터치 기반 입력을 더 포괄적이고 미래 지향적으로 처리하고 싶다면 Pressable API를 확인해 보세요.

이 컴포넌트는 뷰가 터치에 적절히 반응하도록 도와주는 래퍼입니다 (Android 전용). Android에서는 네이티브 상태 드로어블을 사용해 터치 피드백을 표시합니다.

현재는 단일 View 인스턴스만 자식 노드로 지원하며, 이는 해당 View를 추가 속성이 설정된 RCTView 노드 인스턴스로 교체하는 방식으로 구현되었습니다.

네이티브 피드백 터치 가능한 요소의 배경 드로어블은 background 속성을 통해 커스터마이징할 수 있습니다.

예제

---

참고 자료

Props

TouchableWithoutFeedback Props

TouchableWithoutFeedback Props를 상속받는다.

---

background

피드백을 표시하는 데 사용할 배경 드로어블(drawable)의 타입을 결정한다. type 프로퍼티와 type에 따라 추가 데이터를 포함하는 객체를 받는다. 이 딕셔너리를 생성할 때는 정적 메서드 중 하나를 사용하는 것이 권장된다.

타입
backgroundPropType

useForeground

이 값을 true로 설정하면 뷰의 배경이 아닌 전경에 리플 효과를 추가한다. 자식 뷰 중 하나가 자체 배경을 가지고 있거나, 예를 들어 이미지를 표시하는 경우에 유용하다. 이 경우 리플 효과가 가려지는 것을 방지할 수 있다.

이 기능을 사용하기 전에 TouchableNativeFeedback.canUseNativeForeground()를 먼저 확인해야 한다. 이 기능은 Android 6.0 이상에서만 사용할 수 있다. 이전 버전에서 사용하려고 하면 경고가 발생하고 배경으로 대체된다.

타입
bool

hasTVPreferredFocus

Android

TV에서 선호하는 포커스를 설정한다 (View 컴포넌트 문서 참조).

타입
bool

nextFocusDown

Android

TV에서 다음 포커스 아래로 이동하는 기능 (View 컴포넌트 문서 참조).

타입
number

nextFocusForward

Android

TV에서 다음 포커스 이동을 설정한다. View 컴포넌트에 대한 문서를 참고한다.

타입
number

nextFocusLeft

Android

TV에서 다음 포커스가 이동할 왼쪽 뷰를 지정한다. (View 컴포넌트 문서 참고)

타입
number

nextFocusRight

Android

TV에서 오른쪽으로 포커스를 이동할 때 사용한다 (View 컴포넌트의 문서 참조).

타입
number

nextFocusUp

Android

TV에서 다음 포커스를 위로 이동할 때 사용한다(View 컴포넌트의 문서 참조).

타입
number

메서드

SelectableBackground()

tsx

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

안드로이드 테마에서 선택 가능한 엘리먼트에 사용되는 기본 배경(?android:attr/selectableItemBackground)을 나타내는 객체를 생성한다. rippleRadius 매개변수는 리플 효과의 반지름을 조절한다.

SelectableBackgroundBorderless()

tsx

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

안드로이드 테마에서 테두리가 없는 선택 가능한 엘리먼트(?android:attr/selectableItemBackgroundBorderless)의 기본 배경을 나타내는 객체를 생성한다. 안드로이드 API 레벨 21 이상에서 사용할 수 있다. rippleRadius 파라미터는 리플 효과의 반지름을 제어한다.

Ripple()

tsx

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

지정된 색상(문자열로 표현)을 가진 리플 효과를 나타내는 객체를 생성한다. borderless 속성이 true로 평가되면, 리플 효과는 뷰 경계 밖에서도 렌더링된다(예: 네이티브 액션바 버튼). 이 배경 타입은 Android API 레벨 21 이상에서 사용 가능하다.

매개변수:

이름	타입	필수 여부	설명
color	string	예	리플 효과의 색상
borderless	boolean	예	리플 효과가 경계 밖에서 렌더링될지 여부
rippleRadius	?number	아니오	리플 효과의 반지름을 조절

canUseNativeForeground()

tsx

static canUseNativeForeground(): boolean;