Aller au contenu

chooseScope

Décide jusqu’où va le déplacement, le redimensionnement ou la suppression d’une occurrence d’un événement répété.

Type(request: ScopeRequest) => EditScope | null | Promise<EditScope | null>
Par défautun menu « cet événement / les suivants / tous » là où l'événement a été déposé
Modifiable en direct (update())Oui
Déclaré danspackages/dom/src/settings.ts

Une personne glisse une occurrence d’une réunion hebdomadaire : est-ce celle-ci, celle-ci et les suivantes, ou toutes ? Par défaut, le calendrier le demande, avec un petit menu « celle-ci / les suivantes / toutes » là où l’événement a été déposé.

Donnez une fonction pour en décider vous-même — votre propre boîte de dialogue, ou une règle : elle reçoit { instance, kind, proposal? } (kind vaut 'move', 'resize' ou 'delete') (proposal pour un déplacement ou un redimensionnement) et renvoie, ou résout vers, 'this', 'following' ou 'all' — ou null pour annuler, l’événement retournant alors à sa place. Une promesse permet au calendrier d’attendre votre boîte de dialogue. Elle est consultée pour un glissement, un redimensionnement et la touche Suppr ; le « Supprimer » du menu contextuel sur une occurrence a son propre sous-menu celle-ci / les suivantes / toutes (pour l’interdire, écartez event.delete avec contextMenu). Un glissement qui fait passer une occurrence de l’horaire à la journée entière, ou l’inverse, ne change que celle-ci, sans demander.

import { createCalendar } from '@dzcalendar/dom';
import '@dzcalendar/core/recurrence';
createCalendar(element, {
timeZone: 'Europe/Paris',
editable: true,
events: [{ id: 'staff', title: 'Staff meeting', start: '2026-10-19T09:00[Europe/Paris]', rrule: 'FREQ=WEEKLY' }],
// The Delete key: always this one; a drag or a resize asks the application's own dialog.
chooseScope: async ({ kind }) => (kind === 'delete' ? 'this' : (await askScope()) ?? null),
});
declare function askScope(): Promise<'this' | 'following' | 'all' | null>;

En Angular et en Vue elle va dans options ; en React c’est une prop.