br_validators 2.0.3

BRValidators fornece funções para validação e formatação (máscaras) de dados comuns no Brasil, como CPF, CNPJ, PIS/PASEP, CEP, telefones e CNH.

BRValidators

Descrição

O pacote BRValidators fornece uma série de funções para a validação de diferentes tipos de dados frequentemente usados no Brasil, como CPF, CNPJ, PIS/PASEP, CEP, telefones fixos e móveis, e CNH. Além disso, agora o pacote também fornece máscaras de entrada para esses mesmos dados.

Este pacote é muito útil em muitos cenários diferentes, como em sistemas de cadastro de pessoas ou empresas, sistemas de venda online onde é necessário validar o CEP, ou sistemas de gerenciamento de motoristas onde é necessário validar a CNH.

Instalação

Para instalar o pacote, adicione a seguinte linha ao arquivo pubspec.yaml do seu projeto Dart ou Flutter:

dependencies:
  br_validators: ^latest_version

Não esqueça de substituir latest_version pela versão atual do pacote.

Em seguida, execute o comando flutter pub get (para projetos Flutter) ou pub get (para projetos Dart puros) para baixar e instalar o pacote.

Como usar

BRValidators

Para usar as funções de validação fornecidas pelo pacote, primeiro importe o pacote no seu código:

import 'package:br_validators/br_validators.dart';

Em seguida, você pode usar as funções de validação. Aqui estão alguns exemplos:

bool isValidCPF = BRValidators.validateCPF('123.456.789-09');
bool isValidCNPJ = BRValidators.validateCNPJ('12.345.678/0001-95');
bool isValidPISPASEP = BRValidators.validatePISPASEP('123.45678.90-1');
bool isValidCEP = BRValidators.validateCEP('12345-678');
bool isValidLandlinePhone = BRValidators.validateLandlinePhone('(11) 1234-5678');
bool isValidMobileNumber = BRValidators.validateMobileNumber('(11) 91234-5678');
bool isValidPhoneNumber = BRValidators.validatePhoneNumber('(11) 91234-5678');
bool isValidCNH = BRValidators.validateCNH('12345678909');

Cada função de validação retornará true se o valor fornecido for válido, ou false se não for válido.

BRMasks

Além das funções de validação, o pacote br_validators agora inclui a classe BRMasks, que fornece uma série de máscaras de entrada de texto para formatar vários tipos de dados usados no Brasil. Essas máscaras são úteis para garantir que os dados sejam inseridos em um formato consistente.

Para usar as máscaras de entrada, você precisará primeiro importar a classe BRMasks:

import 'package:br_validators/package:br_validators.dart';

Aqui estão as máscaras disponíveis e como usá-las:

var cpfMask = BRMasks.cpf;
var cepMask = BRMasks.cep;
var cnhMask = BRMasks.cnh;
var cnpjMask = BRMasks.cnpj;
var mobilePhoneMask = BRMasks.mobilePhone;
var landlineMask = BRMasks.landlinePhone;
var pisPasepMask = BRMasks.pisPasep;
var dateMask = BRMasks.date;

Cada máscara pode ser usada com um TextField do Flutter para formatar automaticamente a entrada de texto. Por exemplo:

TextField(
  inputFormatters: [BRMasks.cpf],
),

Contribuindo

Contribuições são bem-vindas! Se você encontrar um bug ou tiver uma sugestão de melhoria, por favor abra uma issue no nosso repositório GitHub.

Licença

Este pacote é licenciado sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.