API Reference

WeeksViewRootProps

interface

Props accepted by WeeksView.Root.

Defined in package/src/weeks-view-types.ts:12

Prop Type Default Description

weekCount* number — Number of week rows to display simultaneously.

firstWeek FirstWeekSpec | undefined — The controlled first visible week. When provided, the component is controlled.

defaultFirstWeek FirstWeekSpec | undefined — The initial first visible week (uncontrolled).

onFirstWeekChange ((date: PlainDate) => void) | undefined — Called when the first visible week changes via navigation or focus movement.

scrollBy "row" | "page" | undefined "row" How much to scroll per navigation step. - "row" — scroll one week row at a time. - "page" — scroll a full page (all visible rows) at a time.

overflowBehavior OverflowBehavior | undefined "unbounded" How navigation behaves at min/max bounds.

onWindowChange ((info: WindowInfo) => void) | undefined — Called when the visible window changes.

children React.ReactNode — React children.

Prop	Type	Default	Description
weekCount*	number	—	Number of week rows to display simultaneously.
firstWeek	FirstWeekSpec \| undefined	—	The controlled first visible week. When provided, the component is controlled.
defaultFirstWeek	FirstWeekSpec \| undefined	—	The initial first visible week (uncontrolled).
onFirstWeekChange	((date: PlainDate) => void) \| undefined	—	Called when the first visible week changes via navigation or focus movement.
scrollBy	"row" \| "page" \| undefined	"row"	How much to scroll per navigation step. - `"row"` — scroll one week row at a time. - `"page"` — scroll a full page (all visible rows) at a time.
overflowBehavior	OverflowBehavior \| undefined	"unbounded"	How navigation behaves at `min`/`max` bounds.
onWindowChange	((info: WindowInfo) => void) \| undefined	—	Called when the visible window changes.
children	React.ReactNode	—	React children.