套件詳情v0.0.3

calendar_awesome

一個可自定義的日曆組件，支援「波斯曆」和「格里高利曆」

AndroidiOSWebmacOSWindowsLinux

pub.dev API 文件原始碼

近 30 天下載: 50
喜歡數: 8
Pub 分數: 135

安裝套件

flutter pub add calendar_awesome

套件介紹

根據套件公開資料產生的選型評估，僅供參考。

一個高度可自訂的日曆小工具，支援伊朗曆與格里曆兩種日期系統。專為無縫整合至Flutter應用程式而設計，提供靈活的樣式、事件標記以及跨月與跨年的順暢導航。此套件非常適合需要根據文化或地區日期格式偏好進行日期選擇的應用程式。支援多個平台，包括Android、iOS、Web、macOS、Windows與Linux，確保廣泛的相容性。開發者可依應用設計需求，客製化外觀與行為。

適用情境

波斯（傑拉利）應用程式中的日期選擇
國際應用中的格里高利曆整合
使用自定標記的事件排程
多平台日期選擇器
可自訂的日曆介面
基於時間的規劃工具

主要特色

支援伊朗曆與格里高利曆
高度可自訂的外觀
事件高亮與標記
跨平台相容性
平滑的月份/年份導航
開發者可擴展的 API

適合對象

面向伊朗或波斯語用戶的應用
需要雙日曆支援的國際應用
希望完全控制日曆 UI 的開發人員
需要多平台日期選擇器的項目
具有複雜日期互動需求的應用程式

使用建議

需要手動處理伊朗曆與格里高利曆之間的轉換
進階自訂的文件有限
可能需要額外的樣式才能適用於非預設主題
未針對非常大的事件資料集進行優化
依賴外部日期解析庫

原始 README

以下為關聯原始碼儲存庫的 README 原文快照，最新內容請造訪原始碼儲存庫。

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