Detalhes do pacotev0.5.0+1

month_year_picker

Seletor de mês e ano inspirado no design do seletor de data do Flutter.

AndroidiOSWebmacOSWindowsLinux

pub.dev Documentação da API Código-fonte

Downloads em 30 dias: 23
Curtidas: 92
Pontos Pub: 160

Instalar pacote

flutter pub add month_year_picker

Visão geral do pacote

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

Um pacote Flutter que fornece um widget de seleção de mês e ano inspirado no design nativo do picker de data do Flutter. Permite aos usuários selecionar um mês e ano específico em uma interface limpa e intuitiva, ideal para formulários que exigem entrada de data sem precisão diária. O seletor é totalmente personalizável e suporta todas as principais plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux. Desenvolvido com os temas Material e Cupertino do Flutter em mente, garante uma UI consistente entre dispositivos.

Casos de uso

Selecionar mês e ano de nascimento
Filtrando dados por mês e ano
Definir datas de aniversário
Configurando datas de início de assinatura
Entrando no ano de formatura

Principais recursos

Suporte a temas Material e Cupertino
Compatibilidade multiplataforma
Aparência personalizável
Integração simples da API
Animações suaves
Nenhuma dependência de bibliotecas externas

Indicado para

Entradas de formulário que exigem seleção de mês/ano
Aplicações baseadas em calendário
Fluxos de configuração do perfil do usuário
Interfaces de filtragem de dados
Aplicativos móveis e web com recursos relacionados a datas

Considerações

Não inclui seleção de dia
Limitado a mês e ano apenas
Requer manipulação manual da formatação de data
Não adequado para intervalos de datas precisos
Pode ser necessário validação adicional para a lógica de negócios

README original

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

Material Month/Year Picker

The month year picker inspired by the Flutter's date picker design.

Quick Start

Open your pubspec.yaml file and add this entry:
```
month_year_picker: ^0.5.0+1
```
OR just run flutter pub add month_year_picker using your preferred terminal app.
Then run flutter pub get.

Import this library into your code:

import 'package:month_year_picker/month_year_picker.dart';

Additionally, ensure your MaterialApp refers to the following localizationsDelegates:

    GlobalMaterialLocalizations.delegate,
    MonthYearPickerLocalizations.delegate,

Usage in code:

final selected = await showMonthYearPicker(
  context: context,
  initialDate: DateTime.now(),
  firstDate: DateTime(2019),
  lastDate: DateTime(2023),
);

Parameters

Parameter	Description
`context`	Must not be `null`. Will be passed to the internal `showDialog` function call.
`initialDate`	Must not be `null` and must fall between the `firstDate` and `lastDate`. The `initialDate` will be truncated to its `year` and `month` components. When the month/year picker is first displayed, it will show the month/year of the `initialDate`, with `initialDate` selected.
`firstDate`	Must not be `null`. The `firstDate` will be truncated to its `year` and `month` components. This is the earliest allowable month/year.
`lastDate`	Must not be `null`. The `lastDate` will be truncated to its `year` and `month` components. This is the latest allowable month/year.
`selectableMonthYearPredicate`	Can be `null`. The function to provide full control over which month/year can be selected. If provided, only the month/year that the `selectableMonthYearPredicate` returns `true` for will be selectable.
`locale`	Can be `null`. If provided, will be used to set the locale for the month/year picker. Otherwise, it defaults to the ambient locale provided by `Localizations`.
`useRootNavigator`	Can be `null`. Will be passed to the internal `showDialog` function call.
`routeSettings`	Can be `null`. Will be passed to the internal `showDialog` function call.
`textDirection`	Can be `null`. If provided, will be used to set the text direction for the month/year picker. Otherwise, it defaults to the ambient locale provided by `Directionality`.
`builder`	Can be `null`. This parameter can be used to wrap the dialog widget with a parent widget.
`initialMonthYearPickerMode`	Must not be `null`. Can be used to have the year picker initially appear in the `MonthYearPickerMode.year` mode. It defaults to the `MonthYearPickerMode.month` mode.

Screenshots

Mode	Screenshot
Month picker in portrait mode with default locale.
Year picker in portrait mode with default locale.
Month picker in portrait mode with Malay locale.
Year picker in portrait mode with Malay locale.
Month picker in portrait mode with Arabic locale.
Year picker in portrait mode with Arabic locale.
Month picker in landscape mode with default locale.
Year picker in landscape mode with default locale.
Month picker in landscape mode with Malay locale.
Year picker in landscape mode with Malay locale.
Month picker in landscape mode with Arabic locale.
Year picker in landscape mode with Arabic locale.