🔌Custom Select Field

Documentação do CustomSelect

Visão Geral

O CustomSelect é um widget personalizado que fornece uma interface para um campo de seleção dropdown. Ele permite aos usuários selecionar um valor de uma lista de itens dropdown, com várias opções de personalização disponíveis para a aparência e validação do campo.

Como Usar

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

dartCopy codeCustomSelect(
  value: seuValorInicial,
  onChanged: (value) {},
  list: suaListaDeItensDropdown,
)

Parâmetros

• value (obrigatório): O valor atualmente selecionado no dropdown.

• onChanged (obrigatório): Uma função callback chamada quando o valor selecionado muda.

• list (obrigatório): A lista de DropdownMenuItem que será exibida no dropdown.

• hintText (opcional): Um texto de dica exibido no campo dropdown quando nenhum item está selecionado.

• textStyle (opcional): Define o estilo do texto exibido no campo dropdown.

• sufixIcon, prefixIcon (opcionais): Ícones exibidos como sufixo ou prefixo do campo dropdown, respectivamente.

• backgroundColor (opcional): A cor de fundo do campo dropdown.

• validator (opcional): Uma função de validação que é chamada para validar o valor selecionado.

• labelStyle, labelText (opcionais): Define o estilo e o texto do rótulo exibido acima do campo dropdown.

• errorStyle (opcional): Define o estilo do texto de erro exibido abaixo do campo dropdown.

• padding (opcional): O espaçamento interno ao redor do widget. O valor padrão é EdgeInsets.symmetric(horizontal: 10).

• borderRadius (opcional): Define o raio da borda do campo dropdown.

• border (opcional): Define a borda ao redor do campo dropdown.

Funcionamento Interno

Quando o CustomSelect é inicializado, ele configura o campo dropdown com base nos parâmetros fornecidos e, em seguida, apresenta uma interface com o campo dropdown, e opcionalmente um rótulo e ícones de prefixo/sufixo. O campo dropdown pode ser validado usando a função de validação fornecida, e mensagens de erro podem ser exibidas abaixo do campo.

Considerações Adicionais

O widget CustomSelect 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 personalização extensa e validação de valor. Ao usar o widget em sua aplicação, você pode fornecer qualquer combinação de parâmetros para atingir a aparência e o comportamento desejados para o seu campo dropdown. Todos os parâmetros são opcionais, exceto value, onChanged, e list, 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.