Socket
Socket
Sign inDemoInstall

@majidh1/jalalidatepicker

Package Overview
Dependencies
0
Maintainers
1
Versions
40
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

    @majidh1/jalalidatepicker

A lightweight and simple jalali datepicker.


Version published
Weekly downloads
960
decreased by-5.97%
Maintainers
1
Created
Weekly downloads
 

Changelog

Source

نسخه 0.9.4

تغییر EventListener به دلیل مشکل در zone.js

Readme

Source

JalaliDatePicker

npm version License




The English version of the documentation may be available Here.



نصب و استفاده

تنظیمات

تاریخچه تغییرات نسخه

نصب و استفاده

1- با استفاده از npm یا فولدر dist در همین مخزن آخرین نسخه را دریافت کنید

    npm i @majidh1/jalalidatepicker
     OR
    https://github.com/majidh1/JalaliDatePicker => /dist/
2- دوفایل زیر را به پروژه اضافه کنید

<link type="text/css" rel="stylesheet" href="jalalidatepicker.min.css" />
<script type="text/javascript" src="jalalidatepicker.min.js"></script>

یا استفاده از CDN

<link rel="stylesheet" href="https://unpkg.com/@majidh1/jalalidatepicker/dist/jalalidatepicker.min.css">
<script type="text/javascript" src="https://unpkg.com/@majidh1/jalalidatepicker/dist/jalalidatepicker.min.js"></script>
3- به inputهای مورد نیاز Attribute زیر را اضافه کنید.
     data-jdp
<input data-jdp>
4- برای شروع کارکرد از تکه کد زیر استفاده کنید
jalaliDatepicker.startWatch();

تنظیمات

Info & Methods

بعد از لود فایل js یک object به نام jalaliDatepicker به صورت global که شامل 4 متد زیر است.ایجاد می‌شود

jalaliDatepicker.startWatch(options);
jalaliDatepicker.show(input);
jalaliDatepicker.hide();
jalaliDatepicker.updateOptions(options);
  1. startWatch(options) شروع کار و پردازش روی input ها
  2. show(input) نمایش روی یک input
  3. hide مخفی شدن
  4. updateOptions آپدیت تنظیمات بعد از startWatch

Options

keydefaultdescription
datetrueامکان انتخاب تاریخ
timefalseامکان انتخاب زمان
hasSecondtrueامکان ثانیه در انتخاب زمان
initTimenullزمان پیشفرض
autoShowtrueنمایش خودکار
autoHidetrueمخفی شدن خودکار هنگام کلیک خارج دیتپیکر یا اینپوت
hideAfterChangetrueمخفی شدن بعد از انتخاب تاریخ
useDropDownYearstrueانتخاب سال به صورت DropDown
separatorChars(object)date: '/'
between: ' '
time: ':'
جداکننده بین سال، ماه و روز
جداکننده بین تاریخ و زمان
جداکننده بین ساعت، دقیقه و ثانیه
persianDigitsfalseاستفاده از کارکترهای یونیکد فارسی به جای کارکترهای انگلیسی
minDatenullمشخص کننده حداقل تاریخ. در صورتی که برابر با today باشد روز جاری است. در صورتی که برابر با attr باشد برابر با مقدار data-jdp-min-date attrubute است
maxDatenullمشخص کننده حداکثر تاریخ. در صورتی که برابر با today باشد روز جاری است. در صورتی که برابر با attr باشد برابر با مقدار data-jdp-max-date attrubute است
initDatenullبرابر با آبجکت تاریخی که به صورت پیشفرض نمایش داده می‌شود در صورتی که تنظیم نشود برابر است با روز جاری.
todaynullبرابر با آبجکت تاریخ برای تعیین روز جاری به صورت پیشفرض از تاریخ سیستم محاسبه میشود
plusHtml"svg"html مربوط به دکمه افزایش سال و ماه
minusHtml"svg"html مربوط به دکمه کاهش سال و ماه
container"body"datepicker در کجا ساخته شود
selector"input[data-jdp]"selector مربوط به autoShow
zIndex1000zIndex مربوط به datepicker
days["ش", "ی", "د", "س", "چ", "پ", "ج"]نام روزهای هفته
months["فروردین", "اردیبهشت", "خرداد", "تیر", "مرداد", "شهریور", "مهر", "آبان", "آذر", "دی", "بهمن", "اسفند"]نام ماه‌های موجود
changeMonthRotateYearfalseبا تغییر ماه سال نیز کم یا زیاد شود
showTodayBtntrueنمایش دکمه امروز
showEmptyBtntrueنمایش دکمه پاکسازی
showCloseBtndynamicنمایش دکمه بستن دیتپیکر
autoReadOnlyInputdynamicفقط خواندنی شدن input دارای datePicker
topSpace0فضای خالی بین بالای datePicker و input (زمانی که دیتپیکر در پایین اینپوت هست)
bottomSpace0فضای خالی بین پایین datePicker و input (زمانی که دیتپیکر در بالای اینپوت هست)
dayRendering-متد رندر یک روز خروجی یک آبجکت از تنظیمات روز است
نمونه‌های codepen:

لینک کالکشن

مثال dayRendering:

برای نمایش تعطیلی 4 روز ابتدایی سال

jalaliDatepicker.startWatch({
  dayRendering:function(dayOptions,input){
    return {
     isHollyDay: dayOptions.month==1 && dayOptions.day<=4,
     // isValid = false, امکان غیر فعال کردن روز
     // className = "nowruz" امکان افزودن کلاس برای درج استایل به روز
    }
  }
})

ATTR On Input:

data-jdp

data-jdp-min-date

data-jdp-max-date

data-jdp-only-date

data-jdp-only-time

Keywords

FAQs

Last updated on 26 Nov 2023

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc