Aller au contenu

editable

Permet à une personne de déplacer, redimensionner et supprimer les événements du calendrier — au pointeur, au clavier ou par le menu contextuel.

Typeboolean
Par défautfalse
Modifiable en direct (update())Oui
Déclaré danspackages/dom/src/settings.ts

Avec editable: true :

  • un événement horaire se glisse vers une autre heure ou un autre jour, et se redimensionne par sa fin (par son début aussi avec eventResizableFromStart) ; un événement d’une journée entière se glisse entre les jours et s’étire sur plusieurs ;
  • le clavier fait de même : M (ou Alt+Entrée) sur un événement le saisit, les flèches le déplacent, Maj+flèches tirent sa fin, Entrée le pose, Échap le remet ;
  • le menu contextuel propose « Déplacer… », « Changer la durée… » et « Supprimer » ;
  • Ctrl/Cmd+Z annule et Ctrl/Cmd+Maj+Z rétablit (keyboardUndo).

Chaque modification est une commande, vérifiée par rules et annulable ; une fois faite, onEventChange(change) l’entend — enregistrez-la, et change.revert() si votre serveur refuse. Les editable, startEditable ou durationEditable propres à un événement l’emportent sur l’editable du calendrier : un true qui lui est propre le rend modifiable dans un calendrier qui ne l’est pas (durationEditable: true seul : redimensionné, pas déplacé) ; un tel événement porte data-editable (move, resize) ; un événement fermé à toute modification (editable: false) n’est pas supprimé non plus.

import { createCalendar } from '@dzcalendar/dom';
const calendar = createCalendar(element, {
timeZone: 'Europe/Paris',
editable: true,
onEventChange: (change) => {
fetch(`/api/events/${change.after?.id}`, { method: 'PUT', body: JSON.stringify(change.after) })
.then((res) => { if (!res.ok) change.revert(); });
},
});
// Later: read-only.
calendar.update({ editable: false });

Dans les frameworks, c’est une entrée : editable en Angular, en React et en Vue ; la modification est (eventChange) en Angular, onEventChange en React, @event-change en Vue.

Glissez un événement, redimensionnez-le par sa fin, ou donnez-lui le focus (Tab ou un clic) et appuyez sur M puis les flèches.