Buscar pacotes, repositórios e categorias de apps

Capa de mask_text_input_formatter
Detalhes do pacotev2.9.0

mask_text_input_formatter

O pacote fornece TextInputFormatter para TextField e TextFormField que formatam a entrada por uma máscara fornecida.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
612 mil
Curtidas
1,3 mil
Pontos Pub
160

Instalar pacote

flutter pub add mask_text_input_formatter

Visão geral do pacote

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

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

README original

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

mask_text_input_formatter

Version Build Status codecov GitHub license

The package provides TextInputFormatter for TextField and TextFormField which format the input by a given mask.

logo

Example

Check 'example' folder for code sample

example

Usage

  1. Follow the install guide

  2. Import the library:

import 'package:mask_text_input_formatter/mask_text_input_formatter.dart';
  1. Create mask formatter:
var maskFormatter = new MaskTextInputFormatter(
  mask: '+# (###) ###-##-##', 
  filter: { "#": RegExp(r'[0-9]') },
  type: MaskAutoCompletionType.lazy
);
  1. Set it to text field:
TextField(inputFormatters: [maskFormatter])

Get value

Get masked text:

print(maskFormatter.getMaskedText()); // -> "+0 (123) 456-78-90"

Get unmasked text:

print(maskFormatter.getUnmaskedText()); // -> 01234567890

Change the mask

You can use the updateMask method to change the mask after the formatter was created:

var textEditingController = TextEditingController(text: "12345678");
var maskFormatter = new MaskTextInputFormatter(mask: '####-####', filter: { "#": RegExp(r'[0-9]') });

TextField(controller: textEditingController, inputFormatters: [maskFormatter])  // -> "1234-5678"

textEditingController.value = maskFormatter.updateMask(mask: "##-##-##-##"); // -> "12-34-56-78"

Categorias

Repositório-fonte

Projetos que usam este pacote

Rankings