KeyboardController
The KeyboardController
module in React Native provides a convenient set of methods for managing the behavior of the keyboard. With seamless runtime adjustments, this module allows developers to dynamically change the windowSoftInputMode
on Android and dismiss the keyboard on both platforms.
Methods​
setInputMode
​
This method is used to dynamically change the windowSoftInputMode
(softwareKeyboardLayoutMode
in Expo terminology) during runtime in an Android application. It takes an argument that specifies the desired input mode. The example provided sets the input mode to SOFT_INPUT_ADJUST_RESIZE
:
KeyboardController.setInputMode(AndroidSoftInputModes.SOFT_INPUT_ADJUST_RESIZE);
To understand the difference between adjustResize
/adjustPan
/adjustNothing
behavior you can look into this post.
A combination of adjustResize
+ edge-to-edge
mode will result in behavior similar to adjustNothing
- in this case window is not resized automatically and content is not moved along with the keyboard position. And it becomes a responsibility of developer to handle keyboard appearance (thus it'll match iOS behavior).
setDefaultMode
​
This method is used to restore the default windowSoftInputMode
(softwareKeyboardLayoutMode
in Expo terminology) declared in the AndroidManifest.xml
(or app.json
in Expo case). It resets the input mode to the default value:
KeyboardController.setDefaultMode();
dismiss
​
This method is used to hide the keyboard. It triggers the dismissal of the keyboard:
KeyboardController.dismiss();
react-native
implementation?The equivalent method from react-native
relies on specific internal components, such as TextInput
, and may not work as intended if a custom input component is used.
In contrast, the described method enables keyboard dismissal for any focused input, extending functionality beyond the limitations of the default implementation.