React Kronos

A fast, intuitive, and elegant date and time picker for React.

Philosophy

• Works straight out of the box with minimal props
• Provide a few props and options that give lots of control
• Allow for granular control when needed
• Style is done in JS and can be easily modified
• Beautiful code and appearance

Rationale

Even though there are many React Date and/or Time components, I'm developing my own because none of them do everything that I need.

Key requirements:

• Separate date and/or time components (many only have date)
• Easily style-able from JS (not have to muck around in the css)
• Return multiple time formats (Date, Moment, ISO, string)
• Lightweight, use no jquery
• Active on focus, disappear on blur
• Efficient keyboard navigation

Demo

Usage

1. NPM install npm install react-kronos
2. Require Kronos import Kronos from 'react-kronos'
3. Use

<Kronos
  date={this.state.datetime}
  onChange={this.onChange}
/>

Props:

• date - Date(), Moment(), ISO, or string (if string, must match format)
• time - Date(), Moment(), ISO, or string (if string, must match format)
• format - string : Moment formatting of date / time
• onChange - function : change method called when there is a new value
• returnAs - string : onChange format JS_DATE, MOMENT, ISO, STRING (default: same as input)
• closeOnSelect - boolean : closes the dropdown when a value is selected (default: true)
• closeOnBlur - boolean : closes the dropdown when the field is blurred (default: true)
• placeholder - string : placeholder text when there is no value
• options:
  • color - string : the highlight color in the UI as a hex
  • corners - number : the pixel size of rounded corners (default: 4)
  • font - string : the font family (default: Source Sans Pro)
  • moment: - object : Moment locale customization
    • lang - string : language (default: en for english)
    • settings - object : properties to override as an object (default: { week: { dow: 1 }, weekdaysMin: ['M', 'T', 'W', 'T', 'F', 'S', 'S'] })

Construction progress

Roadmap

0.1

• date & time inputs
• formatting (input & returning)
• common style variables:
  • highlight color
  • font family
  • rounded corners
• options: customize with moment locale

0.2

• prop: styles - granular styling (overwrite any style, or provide entire theme)
• options:
  • date (restrict calendar to show only days, or with months, or with years)
  • time (set increments, set ranges of time)

0.3

• prop: min - minimum allowable date+time
  • hard (user cannot select a date/time, or type/paste a value)
  • soft (user can select/input values but it becomes red)
• prop: max - maximum allowable date+time
  • hard
  • soft
• support for connected start & end date+time
  • date (show range on calendar)
  • time (show "0 hours", "0.5 hours", "1 hour", &c)

Ideas

• move over to JS with ES6 I just love coffeescript so much :/
• input field masking
• scroll time list as user arrows up+down
• ⇧+arrow uses the higher order unit
• maintain a CHANGELOG
• address required props & non-required (what happens if none are included)
• mobile support
• wide browser compatibility

See Also

Kronos is built from scratch, but heavily inspired by:

• Google Calendar's input fields
• react-widgets datetimepicker
• react-input-calendar

Thanks

• !!! gaearon big thanks to Dan Abramov who has built some incredible react components (hot-loader, dnd), written excellent articles, and answered many questions
• ! vjeux leading the CSS in JS movement