Hoppa till huvudinnehåll

Calendar

Kalender
Storybook
React Aria

Fristående kalenderkomponent

import { Calendar } from '@midas-ds/components'
<Calendar aria-label='Kalender' />

Kalender, October 2026

27
28
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

Användning​

Kalender kan användas när användaren ska välja ett datum eller visualisera ett valt datum. Normalt sett är DatePicker standardvalet men kalendern kan användas när inputfältet inte behövs, inte ligger i direkt anslutning till kalendern, eller om kalendern inte ska presenteras som en popover.

Calendar​

Kalendern accepterar samma props som DatePicker och controlled value sätts med value respektive onChange, uncontrolled value sätts med defaultValue.

RangeCalendar​

Samma props som DateRangePicker, exempel nedan med controlled value:

import { RangeCalendar } from '@midas-ds/components'
import { DateValue } from 'react-aria-components'

export const RangeCalendarExample = () => {
  const [selected, setSelected] = React.useState<{
    start: DateValue
    end: DateValue
  } | null>(null)

  return (
    <>
      <RangeCalendar
        aria-label='Kalender'
        value={selected}
        onChange={setSelected}
      />
      <pre>
        Valda datum:{' '}
        {selected &&
          `${selected?.start.toString()}
           till: ${selected?.end.toString()}`}
      </pre>
    </>
  )
}

Kalender, October 2026

27
28
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
Valda datum:

Månads- och årsväljare​

Sätt showMonthYearPicker för att visa månad och år som separata dropdown-väljare i headern, istället för statisk text. Användaren kan då hoppa direkt till en annan månad eller år, utan att behöva bläddra en månad i taget. Fungerar likadant på både Calendar och RangeCalendar (och därmed även DatePicker/DateRangePicker, som återanvänder dem).

<Calendar
  aria-label='Kalender'
  showMonthYearPicker
/>

Kalender, October 2026

27
28
29
30
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

API​

NameTypeDefaultDescription
errorMessagestring-
showMonthYearPickerfalse

Show month/year picker dropdowns in the header instead of the static heading, letting users jump directly to a month/year instead of paging one month at a time.

className'react-aria-Calendar'

The CSS className for the element. A function may be provided to compute the class based on component state.

visibleDuration{ months: 1 }

The amount of days that will be displayed at once. This affects how pagination works.

createCalendar-

A function to create a new Calendar object for a given calendar identifier. If not provided, the createCalendar function from @internationalized/date will be used.

isDisabledfalse

Whether the calendar is disabled.

autoFocusfalse

Whether to automatically focus the calendar when it mounts.

value-

The current value (controlled).

selectionMode'single'

Whether single or multiple selection is enabled.

isDateUnavailable-

Callback that is called for each date of the calendar. If it returns true, then the date is unavailable.

minValue-

The minimum allowed date that a user may select.

maxValue-

The maximum allowed date that a user may select.

isReadOnlyfalse

Whether the calendar value is immutable.

focusedValue-

Controls the currently focused date within the calendar.

defaultFocusedValue-

The date that is focused when the calendar first mounts (uncontrolled).

isInvalid-

Whether the current selection is invalid according to application logic.

pageBehaviorvisible

Controls the behavior of paging. Pagination either works by advancing the visible page by visibleDuration (default) or one unit of visibleDuration.

firstDayOfWeek-

The day that starts the week.

selectionAlignment'center'

Determines the alignment of the visible months on initial render based on the current selection or current date if there is no selection.

weeksInMonthnumber-

The number of weeks in a month. This overrides the default set by the locale.

defaultValue-

The default value (uncontrolled).

children-

The children of the component. A function may be provided to alter the children based on component state.

style-

The inline style for the element. A function may be provided to compute the style based on component state.

renderDOMRenderFunction<"div", CalendarRenderProps<M>>-

Overrides the default DOM element with a custom render function. This allows rendering existing components with built-in styles and behaviors such as router links, animation libraries, and pre-styled components.

Requirements:

  • You must render the expected element type (e.g. if <button> is expected, you cannot render an <a>).
  • Only a single root DOM element can be rendered (no fragments).
  • You must pass through props and ref to the underlying DOM element, merging with your own prop as appropriate.
slot-

A slot name for the component. Slots allow the component to receive props from a parent component. An explicit null value indicates that the local props completely override all props received from a parent.