Paketdetailsv0.0.3

calendar_awesome

Ein anpassbarer Kalender-Widget für "Jalali" und "Gregorian"

AndroidiOSWebmacOSWindowsLinux

pub.dev API-Dokumentation Quellcode

30-Tage-Downloads: 50
Likes: 8
Pub-Punkte: 135

Paket installieren

flutter pub add calendar_awesome

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein hochgradig anpassbarer Kalender-Widget, der sowohl das jahrezeitliche als auch das gregorianische Datumsystem unterstützt. Speziell für die nahtlose Integration in Flutter-Anwendungen entwickelt, bietet er flexible Gestaltungsoptionen, Ereignismarkierung und reibungslose Navigation über Monate und Jahre hinweg. Das Paket ist ideal für Anwendungen, die eine Datumsauswahl mit kulturellen oder regionalen Datumsformatpräferenzen erfordern. Es unterstützt mehrere Plattformen wie Android, iOS, Web, macOS, Windows und Linux und gewährleistet breite Kompatibilität. Entwickler können Erscheinungsbild und Verhalten an die Designanforderungen der App anpassen.

Anwendungsfälle

Datumsauswahl in persischen (Jalali) Anwendungen
Integration des gregorianischen Kalenders in internationale Apps
Ereignisplanung mit benutzerdefinierten Markern
Multiplattform-Datumsauswahl
Anpassbare Benutzeroberfläche für Kalender
zeitbasierte Planungstools

Hauptmerkmale

Unterstützt persisches und gregorianisches Kalender
Hochgradig anpassbare Erscheinung
Ereignishervorhebung und Markierung
Plattformübergreifende Kompatibilität
Glatte Monats-/Jahresnavigation
Erweiterbare API für Entwickler

Geeignet für

Apps für iranische oder persischsprachige Nutzer
Internationale Apps, die eine Unterstützung für zwei Kalender benötigen
Entwickler, die volle Kontrolle über die Kalender-Oberfläche möchten
Projekte, die mehrplattformfähige Datumsauswahler benötigen
Anwendungen mit komplexen Anforderungen an Datumsinteraktionen

Hinweise

Erfordert manuelle Behandlung der Umrechnung zwischen Jalesi und Gregorianer
Beschränkte Dokumentation für erweiterte Anpassungen
Könnte zusätzliche Stilisierung für nicht-standardmäßige Themen benötigen
Nicht für sehr große Ereignis-Datensätze optimiert
Abhängig von externen Datumsanalyse-Bibliotheken

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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"]