Skip to content

ipiyer/react-monthrange-picker

Repository files navigation

react-monthrange-picker Version Badge

Coverage Status Build Status dependency status dev dependency status License Downloads npm badge

react-monthrange-picker    bottom react-monthrange-picker  left

Example

You can either look at the example application example application

OR

For simple example:

API

Calendar

This component is designed to allow users to select both start month and end month. It also has functionalities to detect varies events like onYearChange, onRender, onSelect, onApply, onCancel, and calendar positioning.

Props

selectedDateRange

MomentRange object representing the current selected date range or initial date range of the calendar. Defaults to the current year.

  selectedDateRange: CustomPropTypes.MomentRangeType
restrictionRange

MomentRange object which restricts the calendar between start and the end date. Defaults between 2000 and 4 years from now.

  restrictionRange: CustomPropTypes.MomentRangeType
direction

direction is the opening direction of the calendar.

  direction: React.PropTypes.oneOf(['top', 'left', 'right', 'bottom'])
onYearChange

onYearChange is a callback fn triggered when the calendar year changes.

  onYearChange: React.PropTypes.func
onRender

onRender is a callback fn triggered when the app rendered first.

  onRender: React.PropTypes.func
onSelect

onSelect is a callback fn triggered when the user month selection changes, the fn is called with the current selection range of type CustomPropTypes.MomentRangeType.

  onSelect: React.PropTypes.func
onApply

onApply is a callback fn triggered when the user clicks the apply button.

  onApply: React.PropTypes.func
onCancel

onCancel is a callback fn triggered when the user clicks the cancel button.

  onCancel: React.PropTypes.func
display

display defaults to false, display true would show the calendar when rendered first.

  display: React.PropTypes.bool
position

position is a way to custom position the element (overrides the centering of calendar).

  position: React.PropTypes.shape({
    top: React.PropTypes.number,
    left: React.PropTypes.number,
  })

Theming

react-monthrange-picker comes with a set of SCSS variables that can be overridden to add your own project-specific theming. react-monthrange-picker also exports the style with the package.json, so you can bundle the css with parcelify. Checkout the example app