Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev0.8.1

formz

Uma representação unificada de formulário em Dart que visa simplificar a representação e validação de formulários de forma genérica.

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
242 mil
Curtidas
919
Pontos Pub
160

Instalar pacote

flutter pub add formz

Visão geral do pacote

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

Formz é um pacote Dart que oferece uma abordagem unificada e genérica para representação e validação de formulários. Simplifica a gestão de estados de formulário ao fornecer uma estrutura consistente para lidar com entradas, regras de validação e mensagens de erro. Criado com simplicidade e reutilização em mente, o Formz permite aos desenvolvedores criar formulários com código boilerplate mínimo, mantendo segurança de tipo e escalabilidade entre plataformas. Integra-se perfeitamente em aplicações Flutter, suportando todas as principais plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux.

Casos de uso

  • Construindo componentes de formulário reutilizáveis
  • Gerenciando lógica de validação de formulários complexos
  • Criando manipulação de estado de formulário consistente
  • Simplificando fluxos de trabalho de envio de formulários
  • Integração com soluções de gerenciamento de estado
  • Suporte a mensagens de erro internacionalizadas

Principais recursos

  • Representação genérica do estado do formulário
  • Suporte de validação embutido
  • Regras de validação extensíveis
  • campos de formulário tipados
  • Boilerplate mínimo
  • Compatibilidade multiplataforma

Indicado para

  • Desenvolvedores Flutter em busca de padrões de formulário limpos
  • Projetos que exigem validação de formulário robusta
  • Equipes que desejam lógica de formulário reutilizável
  • Aplicativos direcionados a múltiplas plataformas
  • Desenvolvedores usando gerenciamento de estado funcional ou reativo

Considerações

  • Requer conhecimento de genéricos do Dart
  • Pode ser necessário configuração adicional para validadores personalizados
  • Melhor combinado com gerenciamento de estado como Bloc ou Provider
  • Não é uma solução de UI completa — foca na lógica do formulário
  • Componentes de interface do usuário embutidos limitados

README original

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

📝 Formz

Very Good Ventures Very Good Ventures

Developed with 💙 by Very Good Ventures 🦄

ci coverage pub package License: MIT style: very good analysis


A unified form representation in Dart. Formz aims to simplify form representation and validation in a generic way.

Create a FormzInput

import 'package:formz/formz.dart';

// Define input validation errors
enum NameInputError { empty }

// Extend FormzInput and provide the input type and error type.
class NameInput extends FormzInput<String, NameInputError> {
  // Call super.pure to represent an unmodified form input.
  const NameInput.pure() : super.pure('');

  // Call super.dirty to represent a modified form input.
  const NameInput.dirty({String value = ''}) : super.dirty(value);

  // Override validator to handle validating a given input value.
  @override
  NameInputError? validator(String value) {
    return value.isEmpty ? NameInputError.empty : null;
  }
}

Interact with a FormzInput

const name = NameInput.pure();
print(name.value); // ''
print(name.isValid); // false
print(name.error); // NameInputError.empty
print(name.displayError); // null

const joe = NameInput.dirty(value: 'joe');
print(joe.value); // 'joe'
print(joe.isValid); // true
print(joe.error); // null
print(name.displayError); // null

Validate Multiple FormzInput Items

const validInputs = <FormzInput>[
  NameInput.dirty(value: 'jan'),
  NameInput.dirty(value: 'jen'),
  NameInput.dirty(value: 'joe'),
];

print(Formz.validate(validInputs)); // true

const invalidInputs = <FormzInput>[
  NameInput.dirty(),
  NameInput.dirty(),
  NameInput.dirty(),
];

print(Formz.validate(invalidInputs)); // false

Automatic Validation

class LoginForm with FormzMixin {
  LoginForm({
    this.username = const Username.pure(),
    this.password = const Password.pure(),
  });

  final Username username;
  final Password password;

  @override
  List<FormzInput> get inputs => [username, password];
}

void main() {
  print(LoginForm().isValid); // false
}

Caching validation results

For cases where the validator method has an expensive implementation, consider using the FormzInputErrorCacheMixin mixin to cache the error result and improve performance.

import 'package:formz/formz.dart';

enum EmailValidationError { invalid }

class Email extends FormzInput<String, EmailValidationError>
    with FormzInputErrorCacheMixin {
  Email.pure([super.value = '']) : super.pure();

  Email.dirty([super.value = '']) : super.dirty();

  static final _emailRegExp = RegExp(
    r'^[a-zA-Z\d.!#$%&’*+/=?^_`{|}~-]+@[a-zA-Z\d-]+(?:\.[a-zA-Z\d-]+)*$',
  );

  @override
  EmailValidationError? validator(String value) {
    return _emailRegExp.hasMatch(value) ? null : EmailValidationError.invalid;
  }
}

Categorias

Dependências

Lista de dependências 1 itens

Repositório-fonte

Projetos que usam este pacote

Rankings