dorj-persian-date-picker
v1.3.3
Published
Dorj Persian Date Picker react component
Readme
Dorj Persian Date Picker
A customizable Persian (Jalali) date and date-time picker React component, supporting both simple and dialog-based inputs, with full Farsi localization and moment-jalaali integration.
Features
- Persian (Jalali) calendar support using
moment-jalaali - Date and date-time input components
- Dialog/modal pickers with calendar UI
- Farsi/Latin number formatting
- Customizable styles and labels
- Keyboard and mouse navigation
- Easily embeddable in forms
Installation
npm install dorj-persian-date-pickerUsage
import { DateInput, DateTimeInput } from 'dorj-persian-date-picker';
function MyComponent() {
return (
<div>
<DateInput
name="myDate"
onChange={date => console.log(date)}
/>
<DateTimeInput
name="myDateTime"
onChange={dateTime => console.log(dateTime)}
/>
</div>
);
}Components
DateInput: Date picker with dialogDateInputSimple: Simple inline date inputDateTimeInput: Date-time picker with dialogDateTimeInputSimple: Simple inline date-time inputDateInputPopup: Alternative dialog date pickerDateTimeInputPopup: Alternative dialog date-time picker
Props
All input components support:
name(string): Input nameonChange(function): Callback with ISO8601 date stringnumberFormat(string):'FARSI'or'LATIN'style(object): Inline stylesclassName(string): CSS class
See each component's source for full prop documentation.
Styling
Default styles are included. You can override them via CSS or the className/style props.
Development
- Build:
npm run build - Dev/watch:
npm run dev
License
MIT
