🔢Custom Quantity Selector

Documentação do CustomQuantitySelector

Visão Geral

O CustomQuantitySelector é um widget personalizado que fornece uma interface para seleção de quantidade. Ele permite aos usuários aumentar ou diminuir a quantidade exibida com botões de adição e subtração e também permite a entrada manual da quantidade.

Como Usar

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

CustomQuantitySelector(
  onMinus: () {},
  onPlus: () {},
  onChanged: (value) {},
  currentAmount: 1,
  minimumItems: 1,
  controller: TextEditingController(),
)

Parâmetros

  • onMinus (obrigatório): Uma função callback chamada quando o botão de subtração é pressionado.

  • onPlus (obrigatório): Uma função callback chamada quando o botão de adição é pressionado.

  • onChanged (obrigatório): Uma função callback chamada sempre que o valor no campo de texto muda.

  • currentAmount (obrigatório): A quantidade atual exibida.

  • minimumItems (obrigatório): O número mínimo de itens que podem ser selecionados.

  • controller (obrigatório): O TextEditingController para o TextField onde a quantidade é exibida e editada.

  • 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.

  • text (opcional): O texto exibido antes do seletor de quantidade.

Funcionamento Interno

Quando o CustomQuantitySelector é inicializado, ele configura o seletor de quantidade com base nos parâmetros fornecidos e, em seguida, apresenta uma interface com ícones de adição e subtração e um campo de texto para entrada manual da quantidade. O usuário pode tocar nos ícones para alterar a quantidade ou pode inserir a quantidade manualmente no campo de texto.

Considerações Adicionais

O widget CustomQuantitySelector 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 e do campo de texto. Ao usar o widget em sua aplicação, é crucial fornecer todas as funções callback e valores iniciais necessários. 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.

Last updated