Detalhes do pacotev0.0.3

calendar_awesome

Um widget de calendário personalizável para "Jalali" e "Gregorian"

AndroidiOSWebmacOSWindowsLinux

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

Downloads em 30 dias: 50
Curtidas: 8
Pontos Pub: 135

Instalar pacote

flutter pub add calendar_awesome

Visão geral do pacote

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

Um widget de calendário altamente personalizável que suporta os sistemas de data Jalali e Gregoriano. Projetado para integração perfeita em aplicativos Flutter, oferece estilos flexíveis, marcação de eventos e navegação suave entre meses e anos. O pacote é ideal para aplicativos que exigem seleção de datas com preferências de formato de data cultural ou regional. Ele suporta múltiplas plataformas, incluindo Android, iOS, Web, macOS, Windows e Linux, garantindo ampla compatibilidade. Os desenvolvedores podem adaptar a aparência e o comportamento para atender aos requisitos de design do aplicativo.

Casos de uso

Seleção de data em aplicativos persas (Jalali)
Integração do calendário gregoriano em aplicativos internacionais
Agendamento de eventos com marcadores personalizados
seletores de data multiplataforma
Interface personalizável para calendários
Ferramentas de planejamento baseadas no tempo

Principais recursos

Suporta calendários jalesi e gregoriano
Aparência altamente personalizável
Destaque e marcação de eventos
Compatibilidade multiplataforma
Navegação suave de mês/ano
API extensível para desenvolvedores

Indicado para

Aplicativos direcionados a usuários iranianos ou falantes de persa
Aplicativos internacionais que precisam de suporte a calendários duplos
Desenvolvedores que desejam controle total sobre a IU do calendário
Projetos que exigem seletor de data multiplataforma
Aplicações com necessidades complexas de interação de data

Considerações

Requer manipulação manual das conversões entre calendário jaleali e gregoriano
Documentação limitada para personalização avançada
Pode ser necessário estilização adicional para temas não padrão
Não otimizado para conjuntos de dados de eventos muito grandes
Depende de bibliotecas externas de análise de data

README original

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

calendar_awesome

A customizable calendar widget (Jalali & Gregorian) for Flutter

Installation

Run this command:

flutter pub add calendar_awesome

or Include instructions on how to install your library using pubspec.yaml:

dependencies:
  calendar_awesome: ^0.0.1

Simple Usage

import 'package:calendar_awesome/calendar_awesome.dart';

CalendarAwesome(
  date: const GregorianDate(2024, 8), /// or JalaliDate(1403,5) 
  onChange: (onChangeParam) {
  print(onChangeParam.date);
  print(onChangeParam.tasks);
  print(onChangeParam.events);
  print(onChangeParam.holidays);
  }
)

Properties for `CalendarAwesome`

Property	Description	Type	Required	Default value
date	To determine the type, year and month of the default calendar `GregorianDate(2024,8)`&`JalaliDate(1403,5)`	CustomDate	YES
events	A list that takes the class `EventClass` and is shown as a dot above the days	List	no	[]
tasks	A list that takes the class `TaskClass` and is shown linearly under the days	List	no	[]
holidays	A list that takes a `HolidayClass` class that displays dates as holidays	List	no	[]
showWeekend	Weekends are closed or not	bool	no	true
activeSelectDate	The user can choose a day or not	bool	no	true
calendarStyle	Gets the `CalendarStyle` class to customize the UI	CalendarStyle	no	CalendarStyle()
header	Custom header instead of default header	Widget Function(PageController, Month)	no	null
onChange	When a day is clicked, it returns the values of that day	void Function(OnChangeParam)	YES

Properties for `CalendarStyle`

Property	Description	Type	Required	Default value
weekendStyle	Style text of holidays	TextStyle	no	null
weekdayStyle	Text style of days of the week	TextStyle	no	null
textWeekdayStyle	Weekday text style	TextStyle	no	TextStyle(color: Colors.black)
direction	Left to right and right to left calendar	TextDirection	no	TextDirection.ltr
textWeekdayAngle	Amount of weekday tax rotation	double	no	0.7
todayColor	Today's color	Color	no	Color.fromARGB(255, 70, 39, 156),
todayStyle	Today's text style	TextStyle	no	null
taskColor	Task color under the days	Color	no	Colors.greenAccent
selectDayWidth	The thickness of the circle around the selected day	double	no	1.2
persianText	Use of Persian text	bool	no	false
scrollDirection	Movement model between pages	Axis	no	null
animationDuration	Duration animation of moving between pages	Duration	no	null
animationCurve	Type of animation to move between pages	Curve	no	null
selectDayColor	The color of the circle around the selected day	Color	no	null
weekdaysText	List of text days of the week	List	no	["Sun", "Mon", "Tue", "Wed", "Thur", "Fri", "Sat"]