Date Range Picker Documentation

The selected date range.

A function that is called when the selected date changes.

The placeholder date, which is used to determine what date to start the segments from when no value exists.

A function that is called when the placeholder date changes.

An array of segments that should be readonly, which prevent user input on them.

A function that returns whether or not a date is unavailable.

The minimum valid date that can be entered.

The maximum valid date that can be entered.

A function that returns whether or not a date is valid.

A callback fired when the value is invalid.

The granularity to use for formatting the field. Defaults to 'day' if a CalendarDate is provided, otherwise defaults to 'minute'. The field will render segments for each part of the date up to and including the specified granularity.

Whether or not to hide the time zone segment of the field.

The id of the element which contains the error messages for the date field when the date is invalid.

The hour cycle to use for formatting times. Defaults to the locale preference

The locale to use for formatting dates.

Whether or not the field is disabled.

Whether or not the field is readonly.

Whether or not the date field is required.

Whether or not to close the popover when a date range is selected.

Whether or not to disable days outside the current month.

Whether or not to use paged navigation for the calendar. Paged navigation causes the previous and next buttons to navigate by the number of months displayed at once, rather than by one month.

Whether or not to prevent the user from deselecting a date without selecting another date first.

The format to use for the weekday strings provided via the weekdays slot prop.

An absolute day of the week to start the calendar on, regardless of locale. 0 is Sunday, 1 is Monday, etc. If not provided, the calendar will default to the locale's first day of the week.

The accessible label for the calendar.

Whether or not to always display 6 weeks in the calendar.

A function that returns whether or not a date is disabled.

The number of months to display at once.

The open state of the popover content.

A callback function called when the component changes the open state, such as from user interaction. It is not called when you set open yourself, so run any related logic where you set it.

A callback function called after the open state changes and all animations have completed.

A function that is called when the end date changes.

A function that is called when the start date changes.

The minimum number of days that can be selected in a range.

The maximum number of days that can be selected in a range.

Whether to automatically reset the range if any date within the selected range becomes disabled.

The format to use for the month strings provided via the months slot prop.

The format to use for the year strings provided via the years slot prop.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the root element when the calendar is invalid.

Present on the root element when the calendar is disabled.

Present on the root element when the calendar is readonly.

Present on the root element.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the element when the field is invalid

Present on the element.

The name of the input field used for form submission. If provided a hidden input will be rendered alongside the field.

The type of field to render (start or end).

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the element when the field is invalid.

Present on the element when the field is disabled.

Present on the element.

The part of the date to render.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the element when the field is invalid

Present on the element when the field is disabled

The type of segment the element represents.

Present on the element.

Whether the popover should open when the trigger is hovered.

The delay in milliseconds before the popover opens after hovering the trigger. Only applies when openOnHover is true.

The delay in milliseconds before the popover closes after the mouse leaves the trigger or content. Only applies when openOnHover is true.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Whether the popover is open or closed.

Present on the trigger element.

The preferred side of the anchor to render the floating element against when open. Will be reversed when collisions occur.

The distance in pixels from the anchor to the floating element.

The preferred alignment of the anchor to render the floating element against when open. This may change when collisions occur.

The distance in pixels from the anchor to the floating element.

The amount in pixels of virtual padding around the viewport edges to check for overflow which will cause a collision.

When true, overrides the side and align options to prevent collisions with the boundary edges.

A boundary element or array of elements to check for collisions against.

The amount in pixels of virtual padding around the viewport edges to check for overflow which will cause a collision.

The sticky behavior on the align axis. 'partial' will keep the content in the boundary as long as the trigger is at least partially in the boundary whilst 'always' will keep the content in the boundary regardless.

When true, hides the content when its anchor is fully clipped by a scroll container or the viewport. This is useful for when you want to hide the content when the user scrolls away.

The strategy to use when updating the position of the content. When 'optimized' the content will only be repositioned when the trigger is in the viewport. When 'always' the content will be repositioned whenever the position changes.

The positioning strategy to use for the floating element. When 'fixed' the element will be positioned relative to the viewport. When 'absolute' the element will be positioned relative to the nearest positioned ancestor.

When true, prevents the body from scrolling when the content is open. This is useful when you want to use the content as a modal.

Use an element other than the trigger to anchor the content to. If provided, the content will be anchored to the provided element instead of the trigger.

Callback fired when an outside interaction event occurs, which is a pointerdown event. You can call event.preventDefault() to prevent the default behavior of handling the outside interaction.

Callback fired when focus leaves the dismissible layer. You can call event.preventDefault() to prevent the default behavior on focus leaving the layer.

The behavior to use when an interaction occurs outside of the floating content. 'close' will close the content immediately. 'ignore' will prevent the content from closing. 'defer-otherwise-close' will defer to the parent element if it exists, otherwise it will close the content. 'defer-otherwise-ignore' will defer to the parent element if it exists, otherwise it will ignore the interaction.

Callback fired when an escape keydown event occurs in the floating content. You can call event.preventDefault() to prevent the default behavior of handling the escape keydown event.

The behavior to use when an escape keydown event occurs in the floating content. 'close' will close the content immediately. 'ignore' will prevent the content from closing. 'defer-otherwise-close' will defer to the parent element if it exists, otherwise it will close the content. 'defer-otherwise-ignore' will defer to the parent element if it exists, otherwise it will ignore the interaction.

Event handler called when auto-focusing the content as it is opened. Can be prevented.

Event handler called when auto-focusing the content as it is closed. Can be prevented.

Whether or not to trap the focus within the content when open.

When true, prevents the text selection from overflowing the bounds of the element.

Whether or not to forcefully mount the content. This is useful if you want to use Svelte transitions or another animation library for the content.

The reading direction of the app.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Whether the popover is open or closed.

Present during the initial open frame. Use this to define the starting styles for CSS transitions.

Present while closing before unmount. Use this to define the ending styles for CSS transitions.

Present on the content element.

The transform origin of the content element.

The available width of the content element.

The available height of the content element.

The width of the anchor element.

The height of the anchor element.

Where to render the content when it is open. Defaults to the body.

Whether the portal is disabled or not. When disabled, the content will be rendered in its original DOM location.

The children content to render.

Present on the root element when the calendar is invalid.

Present on the root element when the calendar is disabled.

Present on the root element when the calendar is readonly.

Present on the root element.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the header element when the calendar is disabled.

Present on the header element when the calendar is readonly.

Present on the header element.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the prev button element when the calendar or this button is disabled.

Present on the prev button element.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the heading element when the calendar is disabled.

Present on the heading element when the calendar is readonly.

Present on the heading element.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the next button element when the calendar or this button is disabled.

Present on the next button element.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the grid element when the calendar is disabled.

Present on the grid element when the calendar is readonly.

Present on the grid element.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the grid row element when the calendar is disabled.

Present on the grid row element when the calendar is readonly.

Present on the grid row element.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the grid head element when the calendar is disabled.

Present on the grid head element when the calendar is readonly.

Present on the grid head element.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the head cell element when the calendar is disabled.

Present on the head cell element when the calendar is readonly.

Present on the head cell element.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the grid element when the calendar is disabled.

Present on the grid element when the calendar is readonly.

Present on the grid body element.

The date for the cell.

The current month the date is being displayed in.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present when the day is disabled.

Present when the day is unavailable.

Present when the day is today.

Present when the day is outside the current month.

Present when the day is outside the visible months.

Present when the day is focused.

Present when the day is selected.

The date in the format "YYYY-MM-DD".

Present on the cell element.

Present when the cell is the start of a selection range.

Present when the cell is the end of a selection range.

Present when the cell is in the middle of a selection range, but not the start or end of the selection.

Present when the cell is highlighted within a selection range.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present when the day is disabled.

Present when the day is unavailable.

Present when the day is today.

Present when the day is outside the current month.

Present when the day is outside the visible months.

Present when the day is focused.

Present when the day is selected.

The date in the format "YYYY-MM-DD".

Present on the day element.

Present when the cell is the start of a selection range.

Present when the cell is the end of a selection range.

Present when the cell is in the middle of a selection range, but not the start or end of the selection.

Present when the cell is highlighted within a selection range.

The month values to render in the select.

The format to use for the month strings provided via the months slot prop. If a function is provided, it will be called with the month number as an argument and should return a string.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the month select element when the calendar is disabled.

Present on the month select element.

The year values to render in the select.

The format to use for the year strings provided via the years slot prop. If a function is provided, it will be called with the year as an argument and should return a string.

The underlying DOM element being rendered. You can bind to this to get a reference to the element.

The children content to render.

Use render delegation to render your own element. See Child Snippet docs for more information.

Present on the year select element when the calendar is disabled.

Present on the year select element.