/datepicker-hijri

Datepicker component for hijri date, made with stenciljs

Primary LanguageTypeScriptMIT LicenseMIT

Built With Stencil

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

Installation

Stand alone:

  • Use CDN
<script src="https://cdn.jsdelivr.net/gh/abublihi/datepicker-hijri@v1.1/build/datepicker-hijri.js"></script>
  • Download files
  1. Download all files in the build directory
  2. 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
on-date-select-close no if you want the datepicker to disapeare on chosing the date only add on-date-select-close

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.

Credits

  • @xsoh Thank for the awesome package moment-hijir.
  • @FezVrasta Thank you for the package popper.js.