# Calendar

> Source: https://design.nanatec.co.ke/components/calendar/
> A month to pick one day from — a move-in date, a due date, the day a reading was taken. It sits in the page; for a field that opens one on demand, use `nana-date-picker`.
> Status: beta
> Since: v0.0.40

Days before `min` or after `max` cannot be reached at all. Days refused by
`isDateDisabled` — weekends, public holidays — can still be reached by
keyboard, so a person moving through the month always knows where they are,
but cannot be chosen.

Arrow keys move by day and week, Home and End to the ends of the week,
Page Up and Page Down by month (by year with Shift); Enter or Space picks.

## Preview

For a form field that opens a calendar on demand, use
[date picker](/components/date-picker/). For a span of days, use
[date range](/components/date-range/).

## Installation

```html
<nana-calendar value="2026-03-15" min="2026-03-01" label="Move-in date"></nana-calendar>
```

```js
const el = document.querySelector("nana-calendar");
el.addEventListener("nana-change", (e) => console.log(e.detail));
```
