Aller au contenu

contextMenu

Décide de ce que propose le menu contextuel sur une case, un jour ou un événement.

TypeMenuHook — (ctx: ContextMenuCtx, defaults: readonly ActionItem[]) => readonly ActionItem[] | null
Par défautles entrées intégrées
Modifiable en direct (update())Oui
Déclaré danspackages/dom/src/settings.ts

Le calendrier ouvre un menu sur un clic droit, un appui long sur un écran tactile, ou la touche Menu / Maj+F10 sur la case ou l’événement qui a le focus. Ses entrées intégrées dépendent de la cible : « Nouvel événement à 14:30 », « Aller à ce jour » sur une plage horaire ; « Ouvrir », « Déplacer… », « Changer la durée… », « Supprimer » sur un événement. Une entrée qui ne s’applique pas est omise — « Nouvel événement » sans onCreateRequest, « Ouvrir » sans onEventOpen, les entrées d’édition sans le droit de modifier ; dans une heure sautée, « Nouvel événement à… » porte une raison. Sans aucune d’elles, le menu du navigateur reste.

contextMenu(ctx, defaults) renvoie les entrées à montrer : ctx contient la target (kind 'slot', 'day' ou 'event', avec son moment, sa date, sa ressource ou son instance d’événement) et le state du calendrier ; defaults sont les entrées intégrées (leurs identifiants : event.create, view.goToDay, event.open, event.move, event.resize, event.delete — sur une occurrence, ses enfants event.delete.this, .following, .all). Gardez-les, réordonnez-les, ajoutez les vôtres — chacune { id, label, enabled, run?, command?, reason?, shortcut?, icon?, children? } ; une entrée enabled: false avec une reason est montrée grisée avec elle — ou renvoyez null (ou []) pour laisser le menu du navigateur. La cible est { kind: 'slot', date, instant, ambiguous, … }, { kind: 'day', date } ou { kind: 'event', instance }, avec resourceId dans une vue ressources. Le menu lui-même — clavier, focus, sous-menus, placement, thème — est celui du calendrier.

import { createCalendar } from '@dzcalendar/dom';
createCalendar(element, {
timeZone: 'Europe/Paris',
editable: true,
contextMenu: ({ target }, defaults) =>
target.kind === 'event'
? [...defaults, { id: 'invoice', label: 'Send the invoice', enabled: true, run: () => console.log('invoice', target.instance.event.id) }]
: defaults,
});

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