/react-calendar

A modular toolkit to build calendar-related things in React

Primary LanguageJavaScriptMIT LicenseMIT

react-calendar

NB: This really needs big refactoring, at this stage it's a failed experiment on how to design third-party components for react. I have some ideas on how to improve/rewrite it, but it will take time, which I don't have much at the moment.

Calendars for React.

Not just calendar component, but a modular toolkit for building everything related to calendars in React, such as Datepickers.

In early alpha stage, documentation and features will arrive.

Example

npm install
npm run

One year calendar (Demo):

<Calendar firstMonth={1}                <!-- Base calendar compoment -->
          date={moment("2014-01-01")}
          weekNumbers={true}
          size={12}>
  <Month date={moment()}                <!-- Pass subcomponents to mark -->
         modifiers={{current: true}}/>  <!-- current month and day -->
  <Day date={moment()}
       modifiers={{current: true}} />
</Calendar>

Each component can be used separately AND passed to other components to modify rendering.

<Month date={moment()} />

If component is passed without date it modifies all components of this type in the tree. Useful, for example, for passing callbacks.

<Calendar firstMonth={1}
          date={moment("2014-01-01")}
          weekNumbers={true}
          size={12}>
  <Day onClick={handleClick} />
</Calendar>

Events

All mouse and touch events are supported on all components with react style onCamelCase props (eg. onClick). Event handlers recieves three arguments - name of the component, date in moment.js format and the original react event.

Styling

There is no style by default, but an example theme using bootstrap is included in less/bootstrap-theme.less.

react-calendar uses SuitCSS style (a variant of BEM) to make default class hierarchy, if you want to add a class that is separate from that hierarchy just pass classes prop to any component. classes is an object with keys as class names and values as boolean-like values (this will be probably changed to just passing array of classes in future API). If you want to add SuitCSS modifier classes (eg rc-Day--current), pass similar object via modifiers prop (again this will probably become an array in next version of API).

For example:

<Day date={moment()} classes={{foo: true}} modifiers={{bar: true}} />

will yield the following classes: "rc-Day rc-Day--bar foo".

TODO

  • Merging of modifiers and classe
  • Docs
  • Calendar should be able to page
  • A component for Year - Calendar is supposed to be a 'controller' component for pageable stuff
  • A component that is on lower level that Day - for events.
  • Utils to create range of components for modifying multiple components easier
  • An example datepicker component using react-calendar
  • Tests