react-native-use-keyboard
v1.0.0
Published
A versatile and lightweight React Native hook for responsive keyboard handling. This hook provides real-time keyboard visibility and height information, supports customizable events, debounce handling for performance optimization, and is adaptable to orie
Downloads
68
Maintainers
Readme
useKeyboard
Hook
Overview
The useKeyboard
hook is designed for React Native applications to easily manage and respond to keyboard events. It provides information about the keyboard's visibility and height, which can be used to adjust the layout or behavior of your application when the keyboard is shown or hidden.
Installation
npm install react-native-use-keyboard
yarn add react-native-use-keyboard
pnpm install react-native-use-keyboard
bun install react-native-use-keyboard
Usage
import { useKeyboard } from "react-native-use-keyboard";
const MyComponent = () => {
const { isVisible, height } = useKeyboard();
return (
<View style={{ flex: 1 }}>
<View style={{ flex: 1 }}>
<Text>My Component</Text>
</View>
{isVisible && (
<View style={{ height }}>
<Text>Keyboard is visible</Text>
</View>
)}
</View>
);
};
API
useKeyboard(customEvents?: CustomEvents): KeyboardInfo
Parameters
customEvents
(optional): An object to customize the keyboard event names. It has the following structure:show
: AKeyboardEventName
to specify a custom event name for keyboard show events.hide
: AKeyboardEventName
to specify a custom event name for keyboard hide events.
Return Value
useKeyboard
returns an object containing the following properties:
isVisible
: A boolean indicating whether the keyboard is currently visible.height
: A number representing the height of the keyboard in pixels.
License
MIT