Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/farshaddavoudi/blazor.persiandatepicker

A Jalali (Persian) and Gregorian (Miladi) dual datepicker library for Blazor applications
https://github.com/farshaddavoudi/blazor.persiandatepicker

blazor blazor-server blazor-webassembly calendar-component component csharp datepicker datepicker-component jalali-date jalali-date-picker javascript-calendar nuget persian-calendar persian-datepicker razor razor-components

Last synced: 3 days ago
JSON representation

A Jalali (Persian) and Gregorian (Miladi) dual datepicker library for Blazor applications

Awesome Lists containing this project

README

        

# Blazor.PersianDatePicker

[![NuGet Version](https://img.shields.io/nuget/v/Blazor.PersianDatePicker.svg?style=flat)](https://www.nuget.org/packages/Blazor.PersianDatePicker/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://raw.githubusercontent.com/farshaddavoudi/Blazor.PersianDatePicker/master/LICENSE)

##### 🎈 Optimize design after `v2.0.0` | Mark holidays (optional) after `v3.5.0` — Thanks to [@Mostafa-Moradi](https://github.com/Mostafa-Moradi) for asking [the feature](https://github.com/farshaddavoudi/Blazor.PersianDatePicker/issues/93)

> ✨ **Important fix in v3.4.0 — update your package**: The 1403 Jalali leap year was miscalculated therefore all dates in the next Jalali year (1404) were wrong by one day. It is resolved now. Thanks to [@web724online](https://github.com/web724online) for creating [the issue](https://github.com/farshaddavoudi/Blazor.PersianDatePicker/issues/89).

> ✨ **Important fix in v3.2.0**: When we set the bound parameter value to some date by code (for example in the `OnInitialize` method of our component) and then click on the input, the selected date in the datepicker was always today, not that date. It is resolved now. Thanks to [@EsmaeelAmarloo](https://github.com/EsmaeelAmarloo) for creating [the issue](https://github.com/farshaddavoudi/Blazor.PersianDatePicker/issues/60#issuecomment-1820790657).

## Compatibility:
It is compatible and installable on all .NET 5, .NET 6, .NET 7 and .NET 8 Blazor projects

## Usage:

1- Install **Blazor.PersianDatePicker** from Nuget.org

2- Add `` to your **index.html** or **_Host.cshtml** or **App.razor** *(in .NET8)*

3- Add `` to your **index.html** or **_Host.cshtml** or **App.razor** *(in .NET8)*

4- Add `@using Blazor.PersianDatePicker` to **_imports.razor**

5- Use the component **InputPersianDatePicker**

## Options:

```csharp

```

> #### 💡 You can add multi-instances of InputPersianDatePicker components on a page and all of them work independently without any problem

## Sample template for fast usage:
#### Copy from here then paste in your project; change some options and you're done.

```razor

```

## Performance:

* `js` size (gzipped) ⇒ **35 kb**

* `css` size (gzipped) ⇒ **5 kb**

* `dll` size (gzipped) ⇒‌ **9 kb**

## Special Thanks:
*This project is ported from [pwt.datepicker](https://github.com/babakhani/pwt.datepicker) project with a lot of customizations and optimizations for easy and fast use for Blazor applications. Therefore, I appreciate the great effort of Reza Babakhani @babakhani and all contributors of that project*