🔢Custom Number Counter

Documentação do CustomNumberCounter

Visão Geral

O CustomNumberCounter é um widget personalizado que fornece uma interface de contador numérico para a interface do usuário. Ele permite aos usuários aumentar ou diminuir o número exibido com botões de adição e subtração.

Como Usar

Para usar o CustomNumberCounter, você deve inicializá-lo no seu código e passar os parâmetros necessários. Aqui está um exemplo básico:

CustomNumberCounter(
  counter: 5,
  onChanged: (value) {
    print("O valor do contador é: $value");
  },
)

Parâmetros

• counter (obrigatório): O valor inicial do contador.

• maxNumber, minNumber (opcionais): Os valores máximo e mínimo permitidos para o contador. O valor padrão é 9999 e 1, respectivamente.

• onChanged (opcional): Uma função callback chamada sempre que o valor do contador muda. Retorna o valor atual do contador.

• counterTextStyle (opcional): Define o estilo do texto do número exibido.

• padding (opcional): Espaçamento interno ao redor do widget. O valor padrão é EdgeInsets.fromLTRB(40, 12, 40, 12).

• border, mainBorder (opcionais): Definem a borda ao redor dos botões de adição e subtração e do retângulo que exibe o número, respectivamente.

• counterHeight, counterWidth (opcionais): Definem as dimensões do retângulo que exibe o número. O padrão é 50 e 100, respectivamente.

• addIconSize, subIconSize (opcionais): Definem o tamanho dos ícones de adição e subtração, respectivamente.

• addIconColor, subIconColor (opcionais): Definem as cores dos ícones de adição e subtração, respectivamente.

• mainColor (opcional): Define a cor de fundo do retângulo que exibe o número.

• borderRadius, mainBorderRadius (opcionais): Definem o raio da borda dos botões de adição e subtração e do retângulo que exibe o número, respectivamente.

Funcionamento Interno

Quando o CustomNumberCounter é inicializado, ele configura o valor inicial do contador e, em seguida, apresenta uma interface com ícones de adição e subtração. O usuário pode tocar nos ícones para alterar o valor do contador. Além disso, o widget está configurado para limitar o valor do contador com base nos valores máximo e mínimo fornecidos.

Considerações Adicionais

O widget CustomNumberCounter foi projetado para ser flexível e fácil de usar. Ele não apenas fornece uma interface visual intuitiva, mas também permite uma interação manual direta através dos botões de adição e subtração. Ao usar o widget em sua aplicação, é crucial fornecer o valor inicial do contador. Todos os outros parâmetros são opcionais e têm valores padrão associados a eles. Se você encontrar qualquer comportamento inesperado ou precisar de funcionalidades adicionais, pode ser necessário ajustar os parâmetros ou considerar a adição de mais propriedades personalizadas.