PasswordChecklist Widget #

O widget PasswordChecklist em Flutter exibe regras de validação de senha em tempo real, indicando quais condições foram atendidas. Totalmente customizável em cores, mensagens, ícones e layout.

Uso básico #

PasswordChecklist(
  controller: myController,
  minCharacters: 8,
  onValidationChanged: (isValid) {
    setState(() => _isPasswordValid = isValid);
  },
)

Parâmetros (versão 2.x) #

Compatibilidade com 1.x #

A versão 2.0.0 é retrocompatível com 1.x. Parâmetros existentes mantêm o mesmo comportamento. Novos parâmetros são opcionais com defaults sensatos.

Exemplos de customização #

Regex de caracteres especiais #

PasswordChecklist(
  controller: controller,
  onValidationChanged: (_) {},
  specialCharactersRegex: RegExp(r'[!@#\$%&*]'),
)

Ordem customizada das regras #

import 'package:password_check/password_check.dart';

PasswordChecklist(
  controller: controller,
  onValidationChanged: (_) {},
  ruleOrder: [
    PasswordRuleType.uppercase,
    PasswordRuleType.lowercase,
    PasswordRuleType.number,
    PasswordRuleType.minCharacters,
    PasswordRuleType.specialCharacter,
  ],
)

Ícone por regra #

PasswordChecklist(
  controller: controller,
  onValidationChanged: (_) {},
  customIconBuilder: (ruleId, isValid) {
    return Icon(
      isValid ? Icons.check_circle : Icons.cancel,
      color: isValid ? Colors.green : Colors.red,
      size: 20,
    );
  },
)

Builder customizado (controle total) #

PasswordChecklist(
  controller: controller,
  onValidationChanged: (_) {},
  itemBuilder: (item) {
    return ListTile(
      leading: Icon(
        item.isValid ? Icons.done : Icons.pending,
        color: item.effectiveColor,
      ),
      title: Text(item.message),
    );
  },
)

Internacionalização #

PasswordChecklist(
  controller: controller,
  onValidationChanged: (_) {},
  eightCharactersMessage: 'At least 8 characters',
  specialCharacterMessage: 'One special character',
  numberMessage: 'One number',
  uppercaseMessage: 'One uppercase letter',
  lowercaseMessage: 'One lowercase letter',
  onlyNumbersMessage: 'Not only numbers',
)