Aller au contenu

JavaScript sans framework

Aucun framework n’est nécessaire : createCalendar(element, options) dessine un calendrier dans un élément et renvoie un objet pour le piloter.

Fenêtre de terminal
npm install @dzcalendar/core @dzcalendar/dom @dzcalendar/theme

Un élément où dessiner :

<div id="agenda"></div>

et un module qui le remplit :

import '@dzcalendar/theme/dzcalendar.css';
import { Temporal, loadTemporal } from '@dzcalendar/core';
import { createCalendar } from '@dzcalendar/dom';
import '@dzcalendar/core/recurrence'; // les événements répétés (rrule)
// Tout de suite si le navigateur a Temporal (Chrome, Edge, Firefox) ; Safari charge d'abord son polyfill.
await loadTemporal();
const calendar = createCalendar(document.getElementById('agenda')!, {
timeZone: 'Europe/Paris', // le fuseau dans lequel le calendrier est dessiné
locale: 'fr-FR',
initialView: 'timeGridWeek', // dayGridMonth, timeGridWeek, timeGridDay…
initialDate: Temporal.PlainDate.from('2026-10-21'),
editable: true,
selectable: true,
events: [
{ id: 'a', title: 'Consultation', start: '2026-10-21T09:00[Europe/Paris]', duration: { minutes: 45 } },
// Son propre fuseau : dessiné à 17 h à Paris.
{ id: 'b', title: 'Appel Chicago', start: '2026-10-22T10:00[America/Chicago]', duration: { hours: 1 } },
{ id: 'c', title: 'Congé', start: '2026-10-23', allDay: true },
{ id: 'w', title: 'Visite', start: '2026-10-19T08:00[Europe/Paris]', duration: { hours: 2 }, rrule: 'FREQ=WEEKLY;BYDAY=MO,WE' },
],
onEventClick: (instance) => console.log(instance.event.title, String(instance.event.start)),
onSelect: (selection) => console.log(String(selection.start), String(selection.end)),
});

Voici ce calendrier, tournant sur les sources actuelles de DzCalendar. Déplacez un événement, redimensionnez-le, sélectionnez une plage d’heures, appuyez sur Ctrl+Z :

Les instants sont des valeurs Temporal ou des chaînes ISO 8601 qui portent un fuseau IANA (2026-10-21T09:00[Europe/Paris]). L’appel de Chicago garde son fuseau : il est dessiné à 17 h à Paris, et suivrait les changements d’heure de Chicago. Le dimanche 25 octobre 2026, Paris recule ses horloges : ce jour compte 25 heures, et la vue semaine montre l’heure répétée.

calendar.update({ … }) change ce qui est demandé et rien d’autre, et dessine une seule fois. Une valeur égale à l’actuelle ne change rien — pas de scintillement, la position de défilement et l’événement qui a le focus sont gardés.

calendar.update({ view: 'dayGridMonth' });
calendar.update({ timeZone: 'America/Chicago', locale: 'en-US' });
calendar.update({ theme: 'night', scheme: 'dark' });

Ce qui peut changer ainsi : la vue et la date, le fuseau et la langue, les événements et les sources, les ressources, les heures ouvrées, les jours masqués, l’en-tête, le thème… Une valeur que le calendrier ne peut pas prendre (une vue inconnue) lève une RangeError et ne change rien.

La navigation a sa propre méthode : calendar.navigate('prev' | 'next' | 'today').

Chaque modification des événements est une commande, de simples données, exécutée par calendar.run(command). Le glisser, le redimensionnement ou le choix de menu d’une personne exécutent ces mêmes commandes.

const result = calendar.run({ type: 'event.move', id: 'a', start: '2026-10-22T10:00[Europe/Paris]' });
if (!result.ok) console.log(result.problems);
calendar.undo();
calendar.redo();

Une commande refusée ne lève jamais d’exception : elle renvoie { ok: false, problems }. Les commandes sont event.create, event.update, event.move, event.resize, event.delete, series.delete, series.split, series.rule, event.repeat et batch.

Une donnée invalide ne lève jamais d’exception

Section intitulée « Une donnée invalide ne lève jamais d’exception »

Un événement illisible est écarté et signalé :

calendar.kernel.getProblems()?.problems;
// [{ code: 'missing-start', severity: …, path: …, detail: … }, …]

Des codes comme missing-start, unknown-zone ou zone-defaulted disent ce qui ne va pas, pour le dernier chargement d’événements. Les options sont la seule exception : createCalendar et update lèvent une RangeError sur une option qu’ils ne peuvent pas prendre, et ne changent rien.

Les vues mois, semaine et jour sont intégrées. Les vues liste et la vue année sont des entrées à part, importées une fois :

import '@dzcalendar/dom/list'; // listDay, listWeek, listMonth, listYear
import '@dzcalendar/dom/multimonth'; // multiMonthYear

Pour une page sans framework — un CMS, du HTML simple, Svelte — @dzcalendar/element définit <dz-calendar> :

<dz-calendar view="timeGridWeek" time-zone="Europe/Paris" locale="fr-FR" editable selectable></dz-calendar>
<script type="module">
import '@dzcalendar/element/define';
import '@dzcalendar/theme/dzcalendar.css';
const cal = document.querySelector('dz-calendar');
cal.events = [{ id: 'a', title: 'Consultation', start: '2026-10-21T09:00[Europe/Paris]' }];
cal.addEventListener('dz-event-click', (e) => console.log(e.detail.event.title));
</script>
  • Attributs, à chaud : view, date (ISO), time-zone, locale, theme, scheme, density, et les booléens editable, selectable, week-numbers, weekends, now-indicator (présents, ou "false").
  • Propriétés : events, resources, sources, et options pour tout le reste. calendar est le calendrier sous-jacent (run, undo, kernel…).
  • Événements : dz-dates-set, dz-select, dz-date-click, dz-event-click, dz-follow-change, dz-calendar-problem, dz-problem… Ils remontent et traversent les shadow roots. Une valeur illisible devient un événement dz-problem, jamais une exception ; ce que le calendrier lui-même n’a pas pu faire comme demandé est un dz-calendar-problem.
  • shadow l’isole dans un shadow root, stylé par les propriétés --tz-* et --dz-*, stylesheet="…" et ::part(calendar), ::part(toolbar).