@fluentui/react-calendar-compat

@fluentui/react-calendar-compat

React Calendar component for Fluent UI React

The calendar control lets people select and view a single date or a range of dates in their calendar. It’s made up of 3 separate views: the month view, year view, and decade view.

Usage

To import Calendar:

import { Calendar } from '@fluentui/react-calendar-compat';

Examples

<Calendar />

Alternatively, run Storybook locally with:

yarn workspace @fluentui/react-calendar-compat start

Compat components

What makes a compat component?

A compat component is a component taken from v8 and partially updated with the v9 toolset while keeping its original functionality and most of the original API surface. The most noticeable change being the removal of all v8 dependencies and using only v9 dependencies. While this is a good first step, this is not the final v9 component. We are working on a fully fleshed v9 replacement that will follow all v9 patterns and conventions.

How publishing the package will be handled

Compat components are not added in the @fluentui/react-components package suite. Instead, these components should be imported from their respective package as shown above. In contrast with components that live in @fluentui/react-components, compat components are to be released as 0.x.1 and there won't be an unstable release (beta/alpha) before this release. This is due to the way we will handle versioning for changes, allowing for breaking changes when necessary.

Versioning for changes

We will take a similar approach as v0 where we will follow this pattern:

• breaking change (major): Since this is a compat component, we will allow breaking changes if absolutely necessary. To accommodate for this, we will denote those changes as a minor version in semver, i.e. 0.(change will be reflected here).x.
• minor and patch: These changes will be reflected in the patch version in semver as 0.x.(change will be reflected here).

Calendar compat Slots API special case

Due to time constraints, Calendar compat is a special case for compat components. We are not moving the API to our slots API. Calendar is extracted from DatePicker compat and moved to this package as is.