Buscar pacotes, repositórios e categorias de apps

Capa de radio_group_v2
Detalhes do pacotev3.3.2

radio_group_v2

Um widget que agrupa botões de opção para que eles possam funcionar juntos, proporcionando uma experiência agradável ao usuário ao fazer seleções no aplicativo.

Downloads em 30 dias
883
Curtidas
32
Pontos Pub
160

Instalar pacote

flutter pub add radio_group_v2

Visão geral do pacote

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

radio_group_v2 é um widget do Flutter que simplifica a criação de botões de opção agrupados, garantindo exclusividade mútua e uma experiência do usuário coerente. Permite que os usuários escolham uma opção de um conjunto, com suporte integrado para personalização, gerenciamento de estado e interações suaves. Ideal para formulários e configurações onde é necessário seleção única, melhora a usabilidade por meio de design intuitivo e comportamento consistente entre plataformas.

Casos de uso

  • Entradas de formulário com seleção única
  • Configurações de preferência do usuário
  • Interfaces de pesquisa ou questionário
  • Fluxos de onboarding
  • Grupos dinâmicos de opções

Principais recursos

  • Seleções mutuamente exclusivas
  • Aparência personalizável
  • Gerenciamento de estado embutido
  • Integração fácil com widgets existentes
  • Suporte a design responsivo

Indicado para

  • Desenvolvedores construindo formulários
  • Designers de UI em busca de consistência
  • Aplicativos que exigem entradas de escolha única
  • Iniciantes do Flutter aprendendo manipulação de estado
  • Projetos que precisam de soluções leves para grupos de rádio

Considerações

  • Limitado a seleção única
  • Nenhuma validação embutida
  • Requer manipulação manual de callbacks de seleção
  • Não adequado para cenários de seleção múltipla
  • Depende das restrições de layout do widget pai

README original

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

Radio Group

A widget that groups radio buttons so they can work together to give the user a pleasant experience when making selections within the app.

A gif demonstrating the radio group in action.

Installation

In the pubspec.yaml of your flutter project, add the following dependency:

dependencies:
  radio_group_v2: ^3.3.1

Import it to each file you use it in:

import 'package:radio_group_v2/radio_group_v2.dart';

Usage

Example 1

This example is a very basic, vertical radio group.

RadioGroupController myController = RadioGroupController();

RadioGroup(
  controller: myController,
  values: ["Choice1", "Choice2", "Choice3"],
)
Example 2

This example is a horizontal radio group with some decoration, and it starts with the first button selected.

RadioGroupController myController = RadioGroupController();

RadioGroup(
  controller: myController,
  values: ["Choice1", "Choice2", "Choice3"],
  indexOfDefault: 0,
  orientation: RadioGroupOrientation.Horizontal,
  decoration: RadioGroupDecoration(
    spacing: 10.0,
    labelStyle: TextStyle(
      color: Colors.blue,
    ),
    activeColor: Colors.amber,
  ),
)
Example 3

This example shows how to programmatically select an item using two different methods.

RadioGroupController myController = RadioGroupController();

List<String> items = ["Choice1", "Choice2", "Choice3"];

RadioGroup(
  controller: myController,
  values: items,
)

// Method 1 - Selects a specific item from the list.
myController.value = items[1]; // Selects Choice2

// Method 2 - Selects whatever item is at the given
//            index in the list.
myController.selectAt(2); // Selects Choice3
Example 4

This example shows how to programmatically select an item using two different silent methods. This means, when the new value in is selected in the list, the onChanged method will not be called.

RadioGroupController myController = RadioGroupController();

List<String> items = ["Choice1", "Choice2", "Choice3"];

RadioGroup(
  controller: myController,
  values: items,
)

// Method 1 - Selects a specific item from the list.
myController.setValueSilently(items[1]); // Selects Choice2

// Method 2 - Selects whatever item is at the given
//            index in the list.
myController.selectSilentlyAt(2); // Selects Choice3
Example 5

This example shows how to retrieve the selected value.

RadioGroupController myController = RadioGroupController();

RadioGroup(
  controller: myController,
  values: ["Choice1", "Choice2", "Choice3"],
)

String selected = myController.value.toString();

If you found this helpful, please consider donating. Thanks!

buy me a coffee      paypal      venmo



Categorias

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.