wheel_chooser

Visão geral do pacote

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

WheelChooser é um widget do Flutter que oferece uma interface visualmente atraente baseada em roda para seleção de valores como números, strings ou widgets personalizados. Inspirado em giradores físicos, permite aos usuários rolar pelas opções com animações suaves, ideal para formulários, configurações ou entradas interativas. O pacote suporta múltiplas plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux, garantindo comportamento consistente entre dispositivos. É leve e fácil de integrar, tornando-se adequado para aplicações que exigem seleção intuitiva de dados.

Casos de uso

Entradas de formulário com escolhas discretas
Seletor de horário ou data
Seletores numéricos personalizados
Configurações com rodas de opções
Aplicativos educacionais interativos

Principais recursos

animação de rolagem suave
Suporta widgets personalizados
Compatibilidade multiplataforma
Quantidade de itens configurável
Integração fácil com a interface existente
design responsivo

Indicado para

Desenvolvedores criando interfaces de formulário
Aplicativos que precisam de seleção visual de dados
Aplicações educacionais ou de jogos
Projetos multiplataforma do Flutter
Designers de interface procurando métodos de entrada envolventes

Considerações

Pode exigir ajuste de desempenho para grandes conjuntos de dados
Validação interna limitada
Não otimizado para atualizações de muito alta frequência
Requer estilização cuidadosa para acessibilidade
Mais adequado para listas de opções pequenas a médias

README original

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

WheelChooser is a widget allowing user to choose numbers/strings/widgets by scrolling spinners with wheel look.

vertical

Getting Started

Install

dependencies:
  wheel_chooser: ^1.1.2

Creating WheelChooser Widget

use it to show Strings

WheelChooser(
    onValueChanged: (s) => print(s),
    datas: ["a", "b", "c"],
  );

use it to show Integers

WheelChooser.integer(
    onValueChanged: (i) => print(i),
    maxValue: 10,
    minValue: 1,
    step: 2,
  );

use it to show display titles and return a value associated with the selected value


List<WheelChoice> aChoices = [
  WheelChoice(value: DateTime(2000,1,1,9,0), title: '9AM'),
  WheelChoice(value: DateTime(2000,1,1,9,30), title: '9:30AM'),
  WheelChoice(value: DateTime(2000,1,1,10,0), title: '10AM'),
  WheelChoice(value: DateTime(2000,1,1,10,30), title: '10:30AM'),
];

WheelChooser.choices(
    choices = aChoices,
    onChoiceChanged: (value) {
      // returns DateTime of selected title
      print('selected time is ${value.hour} hours and ${value.minutes} minutes')
    }
  );

use it to show CustomWidgets

 WheelChooser.custom(
    onValueChanged: (a) => print(a),
    children: <Widget>[
      Text("data1"),
      Text("data2"),
      Text("data3"),
    ],
  );

Usage examples

vertical

WheelChooser.integer(
        onValueChanged: (s) => print(s.toString()),
        maxValue: 18,
        minValue: 1,
        initValue: 5,
        unSelectTextStyle: TextStyle(color: Colors.grey),
      )

vertical

WheelChooser.integer(
        onValueChanged: (s) => print(s.toString()),
        maxValue: 20,
        minValue: 1,
        initValue: 9,
        horizontal: true,
        unSelectTextStyle: TextStyle(color: Colors.grey),
      )

From v0.1.1 support Infinite. From v1.0.0 support null safe.