Skip to content

eventMaxStack

How many overlapping events a time grid draws side by side before “+N”.

Typenumber | 'auto' | null
Default'auto'
Live update (update())Yes
Declared inpackages/dom/src/calendar.ts

Events at the same time share their column’s width. Past this many, the column keeps one lane fewer and puts the rest behind a “+N” in the last lane, one per stretch of time.

  • 'auto' (the default): as many as the column’s width allows, about 2.5rem each — a phone’s narrow columns stack fewer than a desktop’s.
  • A number: at most that many (1: all of a crowded moment behind one “+N”).
  • null: all of them, however thin.

“+N” opens a panel with the events behind it.

import { createCalendar } from '@dzcalendar/dom';
const calendar = createCalendar(element, { timeZone: 'Europe/Paris', eventMaxStack: 3 });
// Later: every event, however thin.
calendar.update({ eventMaxStack: null });

In Angular and Vue it goes in options; in React it is a prop.

Four events overlap on Wednesday morning: at most three, so two show and “+2” holds the rest.

  • dayMaxLanes — the same in a month.
  • timeGrid — the time grid’s hours and scale.
  • hooks — “+N” and its panel.