Skip to content

virtualizeAbove

Above this many events in a view, only what is on screen (and a margin) is mounted.

Typenumber
Default500
Live update (update())No — at creation only
Declared inpackages/dom/src/calendar.ts

A view of a few hundred events mounts them all: a screen reader’s browse mode reads every one. Past this number, the views that scroll mount only what is in the scrolled part (and a margin), and mount the rest as it scrolls in: a week’s columns (counted in events), a list (in rows), a year of months, the Pro’s timeline. A month needs none — its days cap their rows (dayMaxLanes). Infinity never windows; printing (autoPrint, preparePrint()) draws everything first. A negative number throws a RangeError.

It is read when the calendar is made.

import { createCalendar } from '@dzcalendar/dom';
createCalendar(element, { timeZone: 'Europe/Paris', initialView: 'timeGridWeek', virtualizeAbove: 2000 });

In Angular it goes in the defaults (DZ_CALENDAR_DEFAULTS, provideDzCalendar); in React and Vue, in initial.