Skip to content

@jsvision/ui / CalendarOptions

Interface: CalendarOptions ​

Defined in: ui/src/date/calendar.ts:66

Options for a Calendar.

Properties ​

density? ​

optional density?: CalendarDensity

Defined in: ui/src/date/calendar.ts:88

Layout density (default 'comfortable'): 'compact' is tightest (~20×8), 'comfortable' is the roomy default (4-wide cells + a Today footer, ~28×10), 'spacious' adds breathing room (5-wide cells + blank week spacers, ~35×15).


firstDayOfWeek? ​

optional firstDayOfWeek?: 0 | 1

Defined in: ui/src/date/calendar.ts:80

0 = Sunday (default) | 1 = Monday (ISO).


i18n? ​

readonly optional i18n?: I18n

Defined in: ui/src/date/calendar.ts:68

Explicit translation service. Omit it to preserve historical English and Sunday-first behavior.


isDisabled? ​

optional isDisabled?: (date) => boolean

Defined in: ui/src/date/calendar.ts:78

Predicate that dims a day: it stays navigable but cannot be committed.

Parameters ​

date ​

CalendarDate

Returns ​

boolean


max? ​

optional max?: CalendarDate

Defined in: ui/src/date/calendar.ts:76

Inclusive navigation upper bound.


min? ​

optional min?: CalendarDate

Defined in: ui/src/date/calendar.ts:74

Inclusive navigation lower bound (the cursor never leaves [min,max]).


onChange? ​

optional onChange?: (date) => void

Defined in: ui/src/date/calendar.ts:90

Fired when value changes.

Parameters ​

date ​

CalendarDate

Returns ​

void


showWeekNumbers? ​

optional showWeekNumbers?: boolean

Defined in: ui/src/date/calendar.ts:82

Opt-in leading ISO week-number column (default false; adds 3 columns).


today? ​

optional today?: CalendarDate

Defined in: ui/src/date/calendar.ts:72

The day to highlight as "today" (default: the system clock at construction; pass it for tests).


value ​

value: Signal<CalendarDate | null>

Defined in: ui/src/date/calendar.ts:70

Two-way selected day (null = no selection).