react-jewish-datepicker

انتخاب‌گر تاریخ یهودی ری‌اکت

یک کامپوننت عمومی انتخاب‌گر تاریخ یهودی که با ری‌اکت کار می‌کند و از زبان‌های عبری و انگلیسی پشتیبانی می‌کند.

همچنین صفحه دمو و مستندات را ببینید.

نصب

yarn add react-jewish-datepicker

npm install react-jewish-datepicker --save

import "react-jewish-datepicker/dist/index.css";

@import url("react-jewish-datepicker/dist/index.css");

استفاده

#### مثال TypeScript:

import * as React from "react";
import {
  ReactJewishDatePicker,
  BasicJewishDay,
  BasicJewishDate
} from "react-jewish-datepicker";
import "react-jewish-datepicker/dist/index.css";
import {
  JewishMonth,
} from "jewish-dates-core";
export default function App() {
  const [basicJewishDay, setBasicJewishDay] = React.useState();
  const basicJewishDate: BasicJewishDate = {
    day: 13,
    monthName: JewishMonth.Elul,
    year: 5788
  };
  return (
    <>
      

        Hebrew:
         {
            setBasicJewishDay(day);
          }}
        />
      
    
  );
}

#### JavaScript example:

import * as React from "react";
import { ReactJewishDatePicker, BasicJewishDay } from "react-jewish-datepicker";
import "react-jewish-datepicker/dist/index.css";
export default function App() {
  const [basicJewishDay, setBasicJewishDay] = React.useState();
  return (
     {
        setBasicJewishDay(day);
      }}
    />
  );
}

پراپرتی‌ها

| نام پراپرتی | توضیحات | نوع مقدار | | ----------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- | | canSelect | یک تابع می‌پذیرد که تعیین می‌کند آیا یک روز قابل انتخاب است یا نه | (day: BasicJewishDay) => condition ? false : true | | isHebrew | اختیاری. آیا زبان نمایش عبری یا انگلیسی باشد، پیش‌فرض false است | false \| true | | isRange | اختیاری. اجازه انتخاب بازه تاریخ. پیش‌فرض false | false \| true | | onClick | تابع بازگشتی هنگام انتخاب تاریخ | (day: BasicJewishDay) => console.log(day) \| (startDay: BasicJewishDay, endDay: BasicJewishDay) => console.log(startDay, endDay)| | value | اختیاری. مقدار اولیه تاریخ انتخاب‌شده | Date \| BasicJewishDate \| BasicJewishDateRange \| DateRange |

پراپرتی canSelect

پراپرتی canSelect می‌تواند یک تابع سفارشی یا یکی از توابع داخلی زیر را دریافت کند.

#### dontSelectHolidays([isIsrael: boolean]) ⇒ (day: BasicJewishDay) => boolean

پارامتر isIsrael را گرفته و تابعی را برمی‌گرداند که به پراپرتی canSelect داده می‌شود تا انتخاب تعطیلات (مطابق با پارامتر isIsrael) را غیرفعال کند.

| پارامتر | نوع | پیش‌فرض | | -------- | ------- | -------- | | isIsrael | boolean | false |

مثال را اینجا ببینید

#### dontSelectShabat(day: BasicJewishDay) ⇒ boolean

تابعی که به پراپرتی canSelect داده می‌شود تا انتخاب شباط را غیرفعال کند.

مثال را اینجا ببینید

#### dontSelectShabatAndHolidays([isIsrael: boolean]) ⇒ (day: BasicJewishDay) => boolean

پارامتر isIsrael را گرفته و تابعی را برمی‌گرداند که به پراپرتی "canSelect" داده می‌شود. این تابع dontSelectHolidays و dontSelectShabat را ترکیب می‌کند تا هم شباط و هم تعطیلات غیرفعال شوند.

| پارامتر | نوع | پیش‌فرض | | -------- | ------- | -------- | | isIsrael | boolean | false |

نمونه را اینجا ببینید

#### dontSelectOutOfRange(minDate: Date | null, maxDate: Date | null) ⇒ (day: BasicJewishDay) => boolean

یک تاریخ حداقل و حداکثر می‌گیرد و تابعی برمی‌گرداند که به prop "canSelect" داده می‌شود تا از انتخاب خارج از بازه مجاز جلوگیری کند.

می‌توانید فقط به یکی از پارامترها تاریخ بدهید و به دیگری مقدار null بدهید. در این صورت بازه قابل انتخاب تا تاریخ حداکثر یا از تاریخ حداقل خواهد بود.

| پارامتر | نوع | | ------- | ------ | | minDate | Date \| null | | maxDate | Date \| null |

نمونه را اینجا ببینید

توابع کمکی

#### addDates(date: BasicJewishDate | Date, numDays: number) ⇒ Date

یک تابع کمکی برای dontSelectOutOfRange.

یک شیء از نوع BasicJewishDate یا Date می‌گیرد، تعداد روز مشخص (numDays) به تاریخ اضافه می‌کند و سپس تاریخ جدید را برمی‌گرداند.

| پارامتر | نوع | | ------- | ------ | | date | BasicJewishDate \| Date | | numDays | number |

نمونه را اینجا ببینید

#### subtractDates(date: BasicJewishDate | Date, numDays: number) ⇒ Date

یک تابع کمکی برای dontSelectOutOfRange.

یک شیء از نوع BasicJewishDate یا Date می‌گیرد، تعداد روز مشخص (numDays) را از تاریخ کم می‌کند و سپس تاریخ جدید را برمی‌گرداند.

| پارامتر | نوع | | ------- | ------ | | date | BasicJewishDate \| Date |

| numDays | number |

نمونه را اینجا ببینید

jewish-dates-core

برای ساخت یک انتخاب‌گر تاریخ یهودی در vue.js یا angular، به وابستگی اصلی ما مراجعه کنید.

jewish-date

اگر فقط به تبدیل‌کننده تاریخ عبری بدون انتخاب‌گر تاریخ نیاز دارید، می‌توانید از jewish-date استفاده کنید.

مشارکت‌کنندگان

• شمولیک کراویتز
• ساگی تاویل
• یوحنان شینبرگر