React Infinite Calendar

Examples available here: http://clauderic.github.io/react-infinite-calendar/

Features

Infinite scroll – Just keep scrollin', just keep scrollin'
Flexible – Min/max date, disabled dates, disabled days, etc.
Localization and translation – En français, s'il vous plaît!
Customizeable – Customize and theme to your heart's content.
Year selection – For rapidly jumping from year to year
Keyboard support – ⬆️ ⬇️ ⬆️ ⬇️ ⬅️ ➡️ ⬅️ ➡️ ↩️
Events and callbacks – beforeSelect, onSelect, onScroll, yadda yadda yadda.
Mobile-friendly – Silky smooth scrolling on mobile

And mucho, mucho mas 🎉

Installation

Using npm:

$ npm install react-infinite-calendar --save

Then, using a module bundler that supports either CommonJS or ES2015 modules, such as webpack:

// Using an ES6 transpiler like Babel
import InfiniteCalendar from 'react-infinite-calendar';
import 'react-infinite-calendar/styles.css'; // Make sure to import the default stylesheet

// Not using an ES6 transpiler
var InfiniteCalendar = require('react-infinite-calendar');
require('react-infinite-calendar/styles.css');

Alternatively, an UMD build is also available.

<link rel="stylesheet" href="react-infinite-calendar/styles.css">
<script src="react-infinite-calendar/dist/umd/react-infinite-calendar.js"></script>
<script>
var InfiniteCalendar = window.InfiniteCalendar.default;
...
</script>

Usage

Basic Example

import React from 'react';
import { render } from 'react-dom';
import InfiniteCalendar from 'react-infinite-calendar';
import 'react-infinite-calendar/styles.css'; // only needs to be imported once

// Render the Calendar
var today = new Date();
var minDate = Number(new Date()) - (24*60*60*1000) * 7; // One week before today

render(
  <InfiniteCalendar
    width={400}
    height={600}
    selectedDate={today}
    disabledDays={[0,6]}
    minDate={minDate}
    keyboardSupport={true}
  />,
  document.getElementById('root')
);

For more usage examples, see http://clauderic.github.io/react-infinite-calendar/

Prop Types

Property	Type	Default	Description
selectedDate	Date or Boolean	new Date()	Value of the date that appears to be selected. Supports any input format supported by moment.js. Set to `false` if you don't wish to have a date initially selected.
min	Date	new Date(1980,0,1)	The minimum month that can be scrolled to. Supports any input format supported by moment.js
max	Date	new Date(2050,11,31)	The maximum month that can be scrolled to. Supports any input format supported by moment.js
minDate	Date	new Date(1980,0,1)	The minimum date that is selectable. Supports any input format supported by moment.js
maxDate	Date	new Date(2050,11,31)	The maximum date that is selectable. Supports any input format supported by moment.js
display	String	'days'	Whether to display the `years` or `days` view.
locale	Object	See default locale	By default, React Infinite Calendar comes with the `English` locale strings. You can use this to change the language, or change the first day of the week. See moment.js documentation for more details
theme	Object	See default theme	Basic customization of the colors
width	Number or String	400	Width of the calendar. Use number for pixel width, string for percentage, for example: `width={400}` or `width={'80%'}`
height	Number	600	Height of the calendar
rowHeight	Number	56	Height of each row in the calendar (each week is considered a `row`)
className	String		Optional CSS class name to append to the root `InfiniteCalendar` element.
overscanMonthCount	Number	4	Number of months to render above/below the visible months. Tweaking this can help reduce flickering during scrolling on certain browers/devices.
todayHelperRowOffset	Number	4	This controls the number of rows to scroll past before the Today helper appears
disabledDays	Array of Numbers		Array of days of the week that should be disabled. For example, to disable Monday and Sunday: `[0, 6]`
disabledDates	Array of Dates		Array of arbitrary dates that should be disabled. Supports any input format supported by moment.js. For example: `['2016-01-08', new Date(), '20160520', {year: 2015, month: 03, day: 15}]`
beforeSelect	Function		Callback invoked before the state is mutated. Can be used to prevent the state from being changed by returning false. Example: `function(date) { return true / false; }`
onSelect	Function		Callback invoked after beforeSelect() returns true, but before the state of the calendar updates
afterSelect	Function		Callback invoked after the state of the calendar has sucessfully been updated
onScroll	Function		Callback invoked when the scroll offset changes. `function (scrollTop: number) {}`
onScrollEnd	Function		Callback invoked `150ms` after the last onScroll event is triggered. `function (scrollTop: number) {}`
keyboardSupport	Boolean	true	Keyboard support (`left`, `right`, `up`, `down`, `enter`)
autoFocus	Boolean	true	Whether the Calendar root should be auto-focused when it mounts. This is useful when `keyboardSupport` is enabled (the calendar must be focused to listen for keyboard events)
tabIndex	Number	1	Tab-index of the calendar
layout	String	'portrait'	Layout of the calendar. Should be one of `'portrait'` or `'landscape'`
showHeader	Boolean	true	Show/hide the header
shouldHeaderAnimate	Boolean	true	Enable/Disable the header animation
showOverlay	Boolean	true	Show/hide the month overlay when scrolling
showTodayHelper	Boolean	true	Show/hide the floating back to `Today` helper
hideYearsOnSelect	Boolean	true	Whether to automatically hide the `years` view on select.

Dependencies

React Infinite Calendar has few dependencies. It relies on the great work done by react-virtualized/VirtualScroll for handling virtual scrolling logic and Moment.js for handling date manipulation. It also has the following peer dependencies: react, react-dom, react-addons-shallow-compare, and react-addons-css-transition-group.

Reporting Issues

If you find an issue, please report it along with any relevant details to reproduce it. The easiest way to do so is to fork this jsfiddle.

Contributions

Yes please! Feature requests / pull requests are welcome. Have a suggestion or just want to say hello? Come chat on gitter!

Made with ❤︎ in the heart of Montreal.

magicsung/react-infinite-calendar