키보드

Keyboard 모듈은 키보드 이벤트를 제어하는 데 사용한다.

사용 방법

Keyboard 모듈은 네이티브 이벤트를 감지하고 반응할 수 있게 해주며, 키보드를 닫는 등의 변경도 가능하게 한다.

참조

메서드

addListener()

tsx

static addListener: (
  eventType: KeyboardEventName,
  listener: KeyboardEventListener,
) => EmitterSubscription;

addListener 함수는 자바스크립트 함수를 특정 네이티브 키보드 알림 이벤트에 연결한다.

이 함수는 리스너에 대한 참조를 반환한다.

매개변수:

이름	타입	설명
eventName 필수	string	이벤트를 식별하는 문자열. 아래 목록을 참고한다.
callback 필수	function	이벤트가 발생할 때 호출될 함수

eventName

다음 중 하나를 사용할 수 있다:

• keyboardWillShow
• keyboardDidShow
• keyboardWillHide
• keyboardDidHide
• keyboardWillChangeFrame
• keyboardDidChangeFrame

안드로이드에서는 keyboardDidShow와 keyboardDidHide 이벤트만 사용 가능하다. 또한 안드로이드 10 이하 버전에서 android:windowSoftInputMode가 adjustNothing으로 설정된 경우 이벤트가 발생하지 않는다.

dismiss()

tsx

static dismiss();

활성화된 키보드를 닫고 포커스를 제거한다.

scheduleLayoutAnimation

tsx

static scheduleLayoutAnimation(event: KeyboardEvent);

키보드의 움직임과 동기화하여 TextInput(또는 다른 키보드 액세서리 뷰)의 크기나 위치 변경을 조정하는 데 유용하다.

isVisible()

tsx

static isVisible(): boolean;

키보드가 마지막으로 확인된 시점에서 화면에 보이는 상태인지 여부를 나타낸다.

metrics()

tsx

static metrics(): KeyboardMetrics | undefined;

소프트 키보드가 보이는 상태라면, 해당 키보드의 메트릭스를 반환한다.