RangeCalendar

There is no standalone range calendar element in HTML. Two separate <input type="date"> elements could be used, but this is very limited in functionality, lacking in internationalization capabilities, inconsistent between browsers, and difficult to style. RangeCalendar helps achieve accessible and international range calendar components that can be styled as needed.

Installation

npx shadcn@latest add https://jollyui.dev/default/calendar

Composed Components

A RangeCalendar uses the following components, which may also be used standalone or reused in other components.

Reusable Wrapper - Example

If you will use a RangeCalendar in multiple places in your app, you can wrap all of the pieces into a reusable component. This way, the DOM structure, styling code, and other logic are defined in a single place and reused everywhere to ensure consistency.

The installed file includes a reusable wrapper JollyRangeCalendar. This wrapper serves as an excellent starting point for use throughout your codebase.

The JollyRangeCalendar component extends the props of React Aria RangeCalendar and adds:

You can copy this wrapper and create variations as needed for different use cases in your application. This approach promotes consistency while still allowing for flexibility in implementation.

Examples

Basic

Multi-Month

Validation

Unavailable Dates

Non-Continuous Ranges

Error Message

Disabled

Read-only