跳到主要内容
版本:0.83

键盘

Keyboard 模块用于控制键盘事件。

用法

Keyboard 模块允许你监听原生事件并对其作出响应,同时也可以对键盘进行操作,比如将其收起。


参考

方法

addListener()

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

addListener 函数将一个 JavaScript 函数连接到一个指定的原生键盘通知事件。

然后该函数会返回监听器的引用。

参数:

名称类型描述
eventName
必填
string标识你正在监听的事件的字符串。见下方列表。
callback
必填
function事件触发时要调用的函数

eventName

可以是以下任意一种:

  • keyboardWillShow
  • keyboardDidShow
  • keyboardWillHide
  • keyboardDidHide
  • keyboardWillChangeFrame
  • keyboardDidChangeFrame
备注

只有 keyboardDidShowkeyboardDidHide 事件可在 Android 上使用。如果你的 activity 将 android:windowSoftInputMode 设置为 adjustResizeadjustNothing,那么在 Android 10 或以下版本中,这些事件不会被触发。


dismiss()

React TSX
static dismiss();

关闭当前活动的键盘并移除焦点。


scheduleLayoutAnimation

React TSX
static scheduleLayoutAnimation(event: KeyboardEvent);

用于将 TextInput(或其他键盘辅助视图)的大小或位置变化与键盘移动同步。


isVisible()

React TSX
static isVisible(): boolean;

键盘当前最后一次已知是否可见。


metrics()

React TSX
static metrics(): KeyboardMetrics | undefined;

如果键盘可见,则返回软键盘的指标。