Git Product home page Git Product logo

react-jalali-datepicker's Introduction

Jalali React Date-Picker

Build Status All Contributors

🚨 I start to redesigning this package. Here you can see the new artboards that well designed by eanlami. If you want to collabrate for this version feel free to make changes or contact me 😊

alt-text

React component that helps you to makes simple Farsi/Jalali/Shamsi date picker. It also has range date picker you can select multiple days in multiple months.

Installation

$ npm install -S jalali-react-datepicker

Date Picker

props type default
value timestamp | Date | Moment Date
weekend number[] [6]
ArrowLeft React.ReactType default component
ArrowLeft React.ReactType default component
ClockIcon React.ReactType default component
DateIcon React.ReactType default component
timePicker boolean true.
onClickSubmitButton function null. if you passed this will be something like
modalZIndex number 9999
theme object default theme you can see here
label string default is null
open boolean default is false. control opening and close modal from outside
onToggle function default is undefined. this function will be called when the modal open and close state is changed

usage

import React from "react";
import { render } from "react-dom";
import { DatePicker } from "jalali-react-datepicker";

render(<DatePicker />, document.getElementById("root"));

onClickSubmitButton

You can access to datePicker value when submit button is clicked.

example:

function submitExample({ value }) {
  console.log("value ", value);
}

Range Date Picker

You can make range date picker with this component. In the below table you can see all the props you can pass to this component.

Note that all props are optional.

props type default
start string. ex: 1397/5/18 today date
end string. ex: 1397/5/18 today date
weekend number[] [6]
ArrowLeft React.ReactType default component
ArrowRight React.ReactType default component
isRenderingButtons boolean true. if it is false rangeDatePicker doesnt show submit and cancel buttons
onClickSubmitButton function null. if you passed this will be something like this
modalZIndex number 9999
theme object default theme you can see here
fromLabel string default is از تاریخ
toLabel string default is تا تاریخ
open boolean default is false. control opening and close modal from outside
onToggle function default is undefined. this function will be called when the modal open and close state is changed

usage

import React from "react";
import { render } from "react-dom";
import { RangeDatePicker } from "jalali-react-datepicker";

render(<RangeDatePicker />, document.getElementById("root"));

onClickSubmitButton

You can access to start and end date when submit button is clicked.

example:

function submitExample({ start, end }) {
  console.log("start ", start);
  console.log("end ", end);
}

ToDo

  • write DatePicker
  • add label to inputs
  • create codesandbox page for preview
  • add TimePicker

Contributors

Thanks goes to these wonderful people (emoji key):

Reza Khosroshahi
Reza Khosroshahi

💻 📖 💡 🤔 ⚠️
saeedjalali
saeedjalali

💬 🐛 💻 🤔 👀 📢
ZMashhadizadeh
ZMashhadizadeh

💻 📦

This project follows the all-contributors specification. Contributions of any kind welcome!

License

MIT License

react-jalali-datepicker's People

Contributors

rzkhosroshahi avatar dependabot[bot] avatar mehrad77 avatar zmashhadizadeh avatar mehdiraized avatar immorez avatar themasix avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.