Aller au contenu

droppable

Ce qui peut être déposé ici : un élément de la page rendu glissable, ou un événement d’un autre calendrier.

Typeboolean | ((data: unknown) => boolean)
Par défautfalse
Modifiable en direct (update())Oui
Déclaré danspackages/dom/src/settings.ts
  • true : tout. false (par défaut) : rien.
  • Une fonction (data) => boolean : un filtre, qui reçoit la data de l’élément — ou, pour un événement venu d’un autre calendrier, l’événement lui-même.

Un élément de la page devient glissable avec makeDraggable(el, { event, data, create? }) (@dzcalendar/dom/drag) : event est ce qu’il devient (un événement sans son début — l’endroit du dépôt le donne — ou une fonction qui en rend un, lue au début du glissement) ; avec create: false, aucun événement n’est créé et onDrop seul entend le dépôt. Déposé, l’événement est créé par une commande vérifiée comme un geste (les rules s’appliquent), onDrop entend le dépôt et onEventReceive l’événement — revert() l’annule. Un événement glissé depuis un autre calendrier demande que celui-ci soit aussi editable (ou que l’événement soit lui-même modifiable) ; le calendrier qu’il a quitté entend onEventLeave. Le clavier peut tout faire : Entrée sur l’élément le saisit, Tab atteint un calendrier, les flèches le placent, Entrée le dépose.

import { createCalendar } from '@dzcalendar/dom';
import { makeDraggable } from '@dzcalendar/dom/drag';
// A card of the waiting list: it becomes a 30-minute consultation where it is dropped.
makeDraggable(document.getElementById('patient-42')!, {
event: { title: 'Consultation', duration: { minutes: 30 } },
data: { patientId: 42 },
});
createCalendar(element, {
timeZone: 'Europe/Paris',
// Only patients, not the other cards of the page.
droppable: (data) => typeof data === 'object' && data !== null && 'patientId' in data,
onEventReceive: (change) => console.log('booked', change.after?.start.toString()),
});

En Angular et en Vue elle va dans options ; en React c’est une prop. Le dépôt et l’événement sont (dropped) et (eventReceive) en Angular, @dropped et @event-receive en Vue, onDrop et onEventReceive en React.