Aller au contenu

Ressources et timeline (Pro)

Une ressource est ce sur quoi on réserve des événements : un médecin, une salle, une machine, une tâche planifiée. Donnez au calendrier une liste de ressources et il dessine une colonne par ressource (les vues en grille) ou une ligne par ressource (la timeline du Pro). Chaque ressource garde ses propres horaires d’ouverture, lus dans son propre fuseau, et vérifie ses propres règles.

resources est une liste d’objets avec un id et, le plus souvent, un title. Tout autre champ est le vôtre : un service, un étage, un numéro de salle. Les événements se posent sur une ressource avec resourceId (voir Événements sur des ressources).

import { createCalendar } from '@dzcalendar/dom';
import type { EventInput, ResourceInput } from '@dzcalendar/core';
const doctors: ResourceInput[] = [
{ id: 'benali', title: 'Dr Benali' },
{
id: 'haddad',
title: 'Dr Haddad',
timeZone: 'Asia/Riyadh', // où ses horaires sont lus
businessHours: { daysOfWeek: [7, 1, 2, 3, 4], start: '08:00', end: '12:00' },
},
];
const visits: EventInput[] = [{ id: 'a', title: 'Visite', start: '2026-10-21T09:00[Europe/Paris]', resourceId: 'benali' }];
const calendar = createCalendar(element, {
timeZone: 'Europe/Paris',
initialView: 'resourceTimeGridDay',
resources: doctors,
events: visits,
onResourceProblems: (problems) => console.warn(problems),
});
// Plus tard : une autre liste (le même tableau ne change rien).
calendar.update({ resources: doctors.slice(0, 1) });

Une mauvaise entrée ne lève jamais d’exception : une ressource sans id, un doublon, un parent inconnu ou un cycle est signalé à onResourceProblems et le reste est dessiné. Les colonnes sont dans le fuseau du calendrier ; le timeZone d’une ressource dit seulement où ses horaires sont lus : un médecin à Riyad ouvert de 08:00 à 12:00 est grisé hors de 07:00–11:00 à Paris en octobre, et une heure plus tôt (hors de 06:00–10:00) une fois que Paris est passé à l’heure d’hiver.

Groupées, triées, et une ligne « non affecté »

Section intitulée « Groupées, triées, et une ligne « non affecté » »

Les ressources viennent dans l’ordre donné. Pour en changer, nommez un champ :

  • resourceGroupField met un en-tête au-dessus de chaque série de ressources qui partagent la valeur de ce champ ;
  • resourceOrder les trie ('title', '-title' pour l’ordre décroissant, 'floor,title', ou une fonction de comparaison) ;
  • showUnassigned ajoute en premier une ligne, ou une colonne, pour les événements sans ressource.
import { createCalendar } from '@dzcalendar/dom';
import '@dzcalendar/pro';
createCalendar(element, {
timeZone: 'Europe/Paris',
initialView: 'resourceTimelineDay',
resources: [
{ id: 'benali', title: 'Dr Benali', service: 'Cardiologie' },
{ id: 'haddad', title: 'Dr Haddad', service: 'Cardiologie' },
{ id: 'room1', title: 'Salle 1', service: 'Imagerie' },
],
resourceGroupField: 'service',
resourceOrder: '-title',
showUnassigned: true,
editable: true,
});

Déposer un événement sur la ligne « non affecté » le retire de la ressource d’où il vient (ses autres ressources restent) ; l’en sortir le pose sur la ligne où il tombe.

Une ressource avec un parentId se place sous son parent : un service au-dessus de ses médecins. Dans une timeline, une branche se replie. Ce qui est replié est gardé par le calendrier, donc survit à update() : lisez-le avec onResourceToggle pour le garder d’une visite à l’autre, et redonnez-le avec collapsedResources (et collapsedGroups pour les en-têtes de groupe).

import { createCalendar } from '@dzcalendar/dom';
import '@dzcalendar/pro';
const saved = JSON.parse(localStorage.getItem('tree') ?? '{}') as { collapsedResources?: string[]; collapsedGroups?: string[] };
createCalendar(element, {
timeZone: 'Europe/Paris',
initialView: 'resourceTimelineWeek',
resources: [
{ id: 'cardio', title: 'Cardiologie' },
{ id: 'benali', title: 'Dr Benali', parentId: 'cardio' },
{ id: 'haddad', title: 'Dr Haddad', parentId: 'cardio' },
],
...saved,
onResourceToggle: (state) => localStorage.setItem('tree', JSON.stringify(state)),
});

Un événement se pose sur une ressource avec resourceId, ou sur plusieurs avec resourceIds : un événement sur deux ressources est dessiné dans les deux. Les événements sans ressource ne sont pas montrés dans une vue de ressources, sauf si showUnassigned est actif. Un glisser d’une ressource à une autre remplace cette ressource par la nouvelle et garde les autres ; un redimensionnement les garde toutes. Depuis le code, event.move accepte aussi resourceIds.

import { createCalendar } from '@dzcalendar/dom';
import type { EventInput, ResourceInput } from '@dzcalendar/core';
const staff: ResourceInput[] = [
{ id: 'benali', title: 'Dr Benali', eventOverlap: false }, // deux de ses événements ne se chevauchent pas
{ id: 'room1', title: 'Salle 1' },
];
const events: EventInput[] = [
{ id: 'a', title: 'Consultation', start: '2026-10-21T09:00[Europe/Paris]', duration: { minutes: 45 }, resourceId: 'benali' },
{ id: 'b', title: 'Scanner avec Dr Benali', start: '2026-10-21T10:00[Europe/Paris]', duration: { hours: 1 }, resourceIds: ['benali', 'room1'] },
];
const calendar = createCalendar(element, {
timeZone: 'Europe/Paris',
initialView: 'resourceTimeGridDay',
resources: staff,
events,
editable: true,
});
// Le scanner passe dans la salle seule, une heure plus tard.
calendar.run({ type: 'event.move', id: 'b', start: '2026-10-21T11:00[Europe/Paris]', resourceIds: ['room1'] });

Chaque ressource d’un événement vérifie, dans son propre fuseau, son eventConstraint et son eventOverlap (les rules du calendrier s’appliquent là où elle ne dit rien). Un dépôt refusé est dit à onCommandRefused, avec ce qui l’a refusé.

La timeline met les ressources en lignes et le temps en largeur. Son axe est le temps écoulé : un événement est aussi long à l’écran qu’il dure, une journée de 25 heures fait 25 heures de large et une de 23 heures, 23. Les créneaux sont découpés sur l’horloge murale : la nuit du retour à l’heure d’hiver, 02:00 apparaît deux fois. La timeline vient avec @dzcalendar/pro : importez-le une fois et ses huit vues sont enregistrées pour tous les calendriers créés ensuite. Il est MIT pour l’instant ; pas de clé.

Vue Créneau par défaut
timelineDay, resourceTimelineDay 30 minutes
timelineWeek, resourceTimelineWeek 1 heure
timelineMonth, resourceTimelineMonth 1 jour
timelineYear, resourceTimelineYear 1 jour

Les vues resource… dessinent une ligne par ressource ; les autres une seule ligne pour tous les événements. timeline règle l’échelle (slot, en minutes divisant un jour, ou 'day') et maxLanes, les couloirs de la ligne d’une ressource, dont le dernier porte « +N » quand d’autres événements se chevauchent. Les colonnes de la zone des ressources sont viewOptions.timeline.areaColumns, et hooks.resource dessine l’en-tête d’une ligne.

import { createCalendar } from '@dzcalendar/dom';
import '@dzcalendar/pro'; // enregistre la famille timeline et ses vues
createCalendar(element, {
timeZone: 'Europe/Paris',
initialView: 'resourceTimelineWeek',
resources: [
{ id: 'benali', title: 'Dr Benali', room: 'B12' },
{ id: 'haddad', title: 'Dr Haddad', room: 'B14' },
],
viewOptions: { timeline: { areaColumns: [{ field: 'title', header: 'Médecin', width: 170 }, { field: 'room', header: 'Salle' }] } },
timeline: { slot: 60, maxLanes: 3 },
editable: true,
});

Glissez un événement sur une autre ligne, ou « À affecter » sur une ressource.

Pour garder une timeline ouverte sur un mur et qui surveille le présent, voir Supervision en direct.