Visão geral
O pacote mask_text_input_formatter fornece um TextInputFormatter para os widgets TextField e TextFormField do Flutter, permitindo formatação em tempo real de entrada usando máscaras personalizáveis. Ajuda os usuários a inserirem dados como números de telefone, datas ou IDs de forma estruturada, inserindo automaticamente separadores e aplicando regras de formato enquanto digitam. O formatador suporta máscaras dinâmicas e gerencia corretamente a posição do cursor entre plataformas. É ideal para formulários que exigem padrões de entrada consistentes sem validação manual.
Casos de uso
- Entrada de número de telefone com formatação de código do país
- Entrada de data com máscara DD/MM/AAAA
- Formatação de número de cartão de crédito com espaços
- Entradas de padrão numérico ou alfanumérico personalizadas
- Campos de formulário que exigem estrutura de dados rígida
Principais recursos
- Mascaramento de entrada em tempo real
- Suporte para máscaras dinâmicas e estáticas
- Posicionamento correto do cursor durante a edição
- Compatibilidade multiplataforma (Android, iOS, Web, macOS, Windows, Linux)
- Integração fácil com TextField e TextFormField
Indicado para
- Construtores de formulários que precisam de entrada estruturada
- Campos de entrada prontos para internacionalização
- Aplicativos de coleta de dados com requisitos rígidos de formato
- Interfaces de entrada de dados amigáveis ao usuário
- Desenvolvedores procurando lógica mínima de validação
Considerações
- Pode exigir uma definição cuidadosa da máscara para evitar comportamentos inesperados
- Pode interferir em operações de copiar e colar se não for configurado corretamente
- Suporte limitado a máscaras condicionais complexas
- Impacto no desempenho em cenários de entrada de alta frequência
- Não adequado para tipos de entrada não-texto