Skip to main content
Version: Next

PressEvent 객체 타입

사용자가 버튼을 누르는 등 상호작용을 통해 발생한 onPress 이벤트의 콜백 함수에서는 PressEvent 객체가 반환된다. 예를 들어, Button 컴포넌트의 onPress 이벤트가 이에 해당한다.

js
{
changedTouches: [PressEvent],
identifier: 1,
locationX: 8,
locationY: 4.5,
pageX: 24,
pageY: 49.5,
target: 1127,
timestamp: 85131876.58868201,
touches: []
}

키와 값

changedTouches

이전 이벤트 이후로 변경된 모든 PressEvent를 담은 배열이다.

타입선택 여부
PressEvent 배열필수

force
iOS

3D Touch를 사용할 때 가해지는 힘의 양을 나타낸다. 0.0부터 1.0 사이의 float 값을 반환한다.

타입옵션 여부
number

identifier

이벤트에 할당된 고유한 숫자 식별자이다.

타입필수 여부
number필수

locationX

터치 가능 영역 내에서 터치가 시작된 X 좌표 (엘리먼트 기준 상대 위치)

타입필수 여부
number필수

locationY

터치 가능 영역 내에서의 Y 좌표(해당 엘리먼트 기준 상대 위치).

타입필수 여부
number필수

pageX

화면 상에서 터치가 발생한 X 좌표(루트 뷰 기준 상대 위치)를 나타낸다.

타입필수 여부
number필수

pageY

화면 상의 터치 시작점 Y 좌표(루트 뷰 기준 상대 위치)를 나타낸다.

타입필수 여부
number필수

target

PressEvent를 받는 엘리먼트의 노드 ID를 나타낸다.

타입선택 여부
number, null, undefined필수

timestamp는 PressEvent가 발생한 시점의 시간 값을 나타낸다. 이 값은 밀리초 단위로 표현된다.

타입필수 여부
number아니오

touches

화면에 현재 발생한 모든 PressEvent를 담은 배열이다.

타입선택 여부
PressEvent 배열필수

사용되는 컴포넌트