Hijri-datepicker-component NPM

Forked and enhanced version of datepicker-hijri with additional features.

Hijridate picker web component, simple and can be integrated easily with any frameworks. (محدد التاريخ الهجري)

This package created to support my company project and been updated with a CR or Bugs created by our testers

Feel free to request or enhance the code with a PR.

Installation

Stand alone:

Use NPM

 npm i hijri-datepicker-component

Use CDN

<script src="https://cdn.jsdelivr.net/npm/hijri-datepicker-component@latest/dist/datepicker-hijri/datepicker-hijri.js"></script>

Download files

Download all files in the build directory
Include the script datepicker-hijri.js file like in the code below

<script src="build/datepicker-hijri.js"></script>

Usage

Attributes:

name	required	description
reference	yes	an identifier for the element where the datepicker will appear it must be an id for an html element
placement	no	the placement of the the datepicker 'bottom', 'top', 'right', 'left' and 'auto' `default:` bottom, you can use any placement in popper.js
date-format	no	the date format, it is string, `default:` iYYYY/iMM/iDD, any format in moment-hijri will work
selected-date	no	the selected date it is string with the same format of `date-format` prop
placeholder	no
on-date-select-close	no	if you want the datepicker to disapeare on chosing the date only add
auto-set-selected-date	no	if you want the datepicker to auto send initial value for today
min-date	no	if you want the datepicker to set minimum date
max-date	no	if you want the datepicker to set maximum date

Example

In the Example below the input with id calender is the reference for the datepicker-hijri web component, so if you click or focus on the input the datepicker will be shown.

<input type="text" id="calender">
<datepicker-hijri reference="calender" placement="bottom" date-format="iYYYY/iMM/iDD" selected-date="1441/02/01"></datepicker-hijri>

Event `onchange`

in any change on the date, will be firing a change event. so you can listen and respond to the change.

<input type="text" id="calender" onchange="console.log('changed')">
                                <!-- ^^^^^^^^ -->
<datepicker-hijri reference="calender" placement="bottom" date-format="iYYYY/iMM/iDD" selected-date="1441/02/01"></datepicker-hijri>

Demo

Codepen Hijridate picker

Demo Image

how it works

So the datepicker shown and every thing is good, but what is happening, when the user chooses the day, the datepicker will modify the attribute value on the reference with the new value.