키보드

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;

소프트 키보드가 보이는 경우, 해당 키보드의 메트릭스를 반환한다.