keyboard_height_plugin/README.md

59 lines
1.8 KiB
Markdown
Raw Permalink Normal View History

2023-04-28 20:12:19 +00:00
# Keyboard Height Plugin for Flutter
2023-04-28 19:20:59 +00:00
2023-04-28 20:12:19 +00:00
`keyboard_height_plugin` is a Flutter plugin for iOS and Android that provides the keyboard size before the keyboard animation occurs for showing or hiding it. This helps eliminate lag when positioning widgets around the keyboard, such as placing a TextField above the keyboard.
2023-04-28 19:20:59 +00:00
2023-04-28 20:12:19 +00:00
## Installation
2023-04-28 19:20:59 +00:00
2023-04-28 20:12:19 +00:00
To install `keyboard_height_plugin`, add it to your `pubspec.yaml` file under the `dependencies` section:
2023-04-28 19:20:59 +00:00
2023-04-28 20:12:19 +00:00
```yaml
dependencies:
2023-04-28 20:51:49 +00:00
keyboard_height_plugin: ^0.0.4
2023-04-28 20:12:19 +00:00
```
2023-04-28 19:20:59 +00:00
2023-04-28 20:12:19 +00:00
## Usage
To use the `keyboard_height_plugin`, first import it in your Dart file:
```dart
import 'package:keyboard_height_plugin/keyboard_height_plugin.dart';
```
Next, create a stateful widget and declare a variable to store the keyboard height and create an instance of the `KeyboardHeightPlugin`:
```dart
class _HomePageState extends State<HomePage>; {
double _keyboardHeight = 0;
final KeyboardHeightPlugin _keyboardHeightPlugin = KeyboardHeightPlugin();
// ... rest of code ...
}
```
Then, initialize the `KeyboardHeightPlugin` in your `initState` method and listen for changes in the keyboard height:
```dart
@override
void initState() {
super.initState();
_keyboardHeightPlugin.onKeyboardHeightChanged((double height) {
setState(() {
_keyboardHeight = height;
});
});
}
```
Use the `_keyboardHeight` variable to position your widgets around the keyboard.
## Example
For a complete example on how to use the `keyboard_height_plugin`, please refer to the [`example`](example) directory in the repository.
## Contributing
If you encounter any issues or have suggestions for improvements, feel free to open an issue or submit a pull request on the project's GitHub repository.
## License
This plugin is licensed under the [BSD 3-Clause License](LICENSE).