keyboard_visibility

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

O pacote keyboard_visibility é um plugin Flutter que permite aos desenvolvedores detectar o estado de visibilidade do teclado virtual em dispositivos Android e iOS. Ele fornece uma API simples para ouvir eventos de exibição/escondimento do teclado, permitindo que os aplicativos respondam dinamicamente — como ajustar layouts ou rolar conteúdo para dentro da vista. Isso é especialmente útil em formulários ou interfaces de chat onde a entrada do usuário exige feedback visual. O plugin funciona sem problemas entre plataformas com configuração mínima, tornando-o ideal para interfaces responsivas.

Casos de uso

Manipulação de entrada de formulário
Ajustes de interface do aplicativo de bate-papo
Redimensionamento de layout dinâmico
Rolagem até campos focados
Interfaces de usuário responsivas

Principais recursos

Detecção em tempo real do estado do teclado
Suporte multiplataforma (Android e iOS)
API de ouvinte de evento simples
Configuração mínima
Funciona com FocusNode e TextEditingController

Indicado para

Desenvolvedores de aplicativos com formulários intensos
Aplicativos de bate-papo ou mensagens
UIs que exigem layouts dinâmicos com reconhecimento de teclado
Aplicativos que necessitam de tratamento responsivo de entrada
Iniciantes do Flutter explorando recursos específicos da plataforma

Considerações

Não funciona na plataforma da web
Requer gerenciamento adequado de ouvintes de eventos
Pode ser necessário lógica adicional para transições de UI complexas
Limitado à visibilidade do teclado, não ao tamanho ou animação
Sem animações ou transições embutidas

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Notification service for soft-keyboard visibility

Usage

Add the dependency to your pubspec.yaml file in the root folder of your project. Look for the 'dependencies:'-line and add the following line after this line:

keyboard_visibility: any

keyboard_visibility: ^[CURRENT VERSION NUMBER]

(Please note that the two spaces in the beginning of the line are important) Run 'flutter packages get' in your root folder after saving the pubspec.yaml file. For additional documentation about the pubspec.yaml file please refer to the official flutter documentation using packages

Import package:keyboard_visibility/keyboard_visibility.dart, instantiate KeyboardVisibilityNotification and use the Android and iOS notifications to get events about changes of the visibility of the soft-keyboard

The best practice to call the addNewListener function is inside the initState function as in the following example:

import 'package:keyboard_visibility/keyboard_visibility.dart';

@protected
void initState() {
  super.initState();

  KeyboardVisibilityNotification().addNewListener(
    onChange: (bool visible) {
      print(visible);
    },
  );
}

Also check out the example included with the package

Getting Started

For help getting started with Flutter, view the following online documentation.

Buscar pacotes, repositórios e categorias de apps