Documentation
Forms
DateRangePicker
Groups start and end date controls for range selection.
01
See it in context
Preview
July 2026
| Mon | Tue | Wed | Thu | Fri | Sat | Sun |
|---|---|---|---|---|---|---|
| 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 | 1 | 2 |
| 3 | 4 | 5 | 6 | 7 | 8 | 9 |
July 2026
| Mon | Tue | Wed | Thu | Fri | Sat | Sun |
|---|---|---|---|---|---|---|
| 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 | 1 | 2 |
| 3 | 4 | 5 | 6 | 7 | 8 | 9 |
02
Copy a working example
Usage
---
import { DatePicker, DateRangePicker } from '@santi020k/lumen-astro'
---
{/* The runtime keeps the range consistent: picking a start date sets the
minimum of the end input, and vice versa. */}
<DateRangePicker>
<DatePicker aria-label="Start date" value="2026-07-06" />
<DatePicker aria-label="End date" value="2026-07-10" />
</DateRangePicker>---
import { DatePicker, DateRangePicker } from '@santi020k/lumen-astro'
---
{/* The runtime keeps the range consistent: picking a start date sets the
minimum of the end input, and vice versa. */}
<DateRangePicker>
<DatePicker aria-label="Start date" value="2026-07-06" />
<DatePicker aria-label="End date" value="2026-07-10" />
</DateRangePicker>import { DatePicker, DateRangePicker } from '@santi020k/lumen-react'
export const Example = () => (
<>
{/* The runtime keeps the range consistent: picking a start date sets the
minimum of the end input, and vice versa. */}
<DateRangePicker>
<DatePicker aria-label="Start date" defaultValue="2026-07-06" />
<DatePicker aria-label="End date" defaultValue="2026-07-10" />
</DateRangePicker>
</>
)import { DatePicker, DateRangePicker } from '@santi020k/lumen-react'
export const Example = () => (
<>
{/* The runtime keeps the range consistent: picking a start date sets the
minimum of the end input, and vice versa. */}
<DateRangePicker>
<DatePicker aria-label="Start date" defaultValue="2026-07-06" />
<DatePicker aria-label="End date" defaultValue="2026-07-10" />
</DateRangePicker>
</>
)<script type="module">
import { defineLumenElements } from '@santi020k/lumen-elements/define'
defineLumenElements()
</script>
{/* The runtime keeps the range consistent: picking a start date sets the
minimum of the end input, and vice versa. */}
<lumen-date-range-picker>
<lumen-date-picker aria-label="Start date" value="2026-07-06"></lumen-date-picker>
<lumen-date-picker aria-label="End date" value="2026-07-10"></lumen-date-picker>
</lumen-date-range-picker><script type="module">
import { defineLumenElements } from '@santi020k/lumen-elements/define'
defineLumenElements()
</script>
{/* The runtime keeps the range consistent: picking a start date sets the
minimum of the end input, and vice versa. */}
<lumen-date-range-picker>
<lumen-date-picker aria-label="Start date" value="2026-07-06"></lumen-date-picker>
<lumen-date-picker aria-label="End date" value="2026-07-10"></lumen-date-picker>
</lumen-date-range-picker>03
Choose your target
Add this component
Choose the package for your runtime. All adapters share the Lumen stylesheet. Use the matching registry command when you want a local wrapper for that framework.
pnpm add @santi020k/lumen-astropnpm add @santi020k/lumen-astrolumen add DateRangePickerlumen add DateRangePickerpnpm add @santi020k/lumen-reactpnpm add @santi020k/lumen-reactlumen add DateRangePicker --target reactlumen add DateRangePicker --target reactpnpm add @santi020k/lumen-elementspnpm add @santi020k/lumen-elementslumen add DateRangePicker --target elementslumen add DateRangePicker --target elementsAPI reference
Lumen-specific props and runtime attributes for the Astro primitive. React props follow the same names; Elements use equivalent kebab-case attributes where custom elements expose them.
| Attribute | Values | Default | Description |
|---|---|---|---|
| data-ui-date-range-picker | boolean attribute | - | Marks the container to sync min/max constraints between its child DatePicker inputs. |
| class, className | string | "" | Merges custom classes with the generated ui-* root classes. |
| ...native attributes | HTML attributes | - | Forwards standard attributes to the root element unless the component consumes them. |