TouchableNativeFeedback

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

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

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

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

예제

---

참고 자료

Props

TouchableWithoutFeedback Props

TouchableWithoutFeedback Props를 상속한다.

background

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

타입
backgroundPropType

useForeground

이 값을 true로 설정하면 뷰의 배경 대신 전경에 물결 효과를 추가한다. 자식 뷰가 자체 배경을 가지고 있거나 이미지를 표시하는 경우에 유용하다. 이 효과를 사용하면 물결 효과가 다른 요소에 가려지지 않는다.

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

타입
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;