Aller au contenu

Installation

DzCalendar est un ensemble de petits paquets. Le noyau (@dzcalendar/core) connaît les événements, les vues et l’horloge ; il n’a pas de DOM. Le moteur de rendu (@dzcalendar/dom) le dessine. Les paquets des frameworks enveloppent le moteur de rendu, et une feuille de style facultative (@dzcalendar/theme) lui donne son apparence.

Fenêtre de terminal
npm install @dzcalendar/core @dzcalendar/dom @dzcalendar/theme
Paquet Ce qu’il apporte
@dzcalendar/core Le noyau : événements, récurrence, sources, commandes et annulation, vues sous forme de données. Réexporte Temporal.
@dzcalendar/dom createCalendar : vues mois, semaine, jour ; @dzcalendar/dom/list et @dzcalendar/dom/multimonth ajoutent les vues liste et année.
@dzcalendar/theme dzcalendar.css : sept familles de couleurs, claires et sombres, vérifiées pour le contraste WCAG AA.
@dzcalendar/angular <dz-calendar> pour Angular 19 à 22, sans zone ou avec zone.js, en signaux.
@dzcalendar/react <DzCalendar> pour React 18 et 19.
@dzcalendar/vue <DzCalendar> pour Vue 3.4 et 3.5.
@dzcalendar/element <dz-calendar> en Web Component, pour n’importe quelle page.
@dzcalendar/ical Des sources iCalendar.
@dzcalendar/pro Les vues timeline, l’éditeur d’événements, l’impression et les exports.

Temporal vient avec le noyau : import { Temporal } from '@dzcalendar/core'. Là où le navigateur ne l’a pas encore, un polyfill le remplace.

Importez-la une fois, n’importe où dans votre application :

import '@dzcalendar/theme/dzcalendar.css';

Sans elle, le calendrier fonctionne quand même, dans les couleurs du système. Avec elle, trois options choisissent l’apparence, et toutes trois peuvent changer à chaud avec update() :

  • theme : 'standard' (par défaut), 'slate', 'night', 'pastel', 'frost', 'solar', 'contrast', ou l’un des vôtres créé avec defineTheme.
  • scheme : 'auto' (suit le système), 'light' ou 'dark'.
  • density : 'compact', 'comfortable' (par défaut) ou 'spacious' — 48, 72 ou 96 pixels par heure.

Tout le CSS du calendrier est rangé dans deux couches de cascade : n’importe laquelle de vos règles hors couche l’emporte, quelle que soit sa spécificité. À côté de Tailwind, de Bootstrap ou d’un reset global, voyez Thèmes et CSS.

Le même calendrier dans les quatre saveurs : une semaine à Paris, quatre événements, dont un dans le fuseau de Chicago et un qui revient chaque lundi et chaque mercredi.

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();
createCalendar(document.getElementById('agenda')!, {
timeZone: 'Europe/Paris',
locale: 'fr-FR',
initialView: 'timeGridWeek',
initialDate: Temporal.PlainDate.from('2026-10-21'),
editable: true,
events: [
{ id: 'a', title: 'Consultation', start: '2026-10-21T09:00[Europe/Paris]', duration: { minutes: 45 } },
{ 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' },
],
});

Voyez-le fonctionner sur la page JavaScript sans framework, puis la page de votre framework : Angular, React, Vue.

  • Navigateurs : Chrome 99, Firefox 97, Safari / iOS 15.4 et suivants (couches de cascade). Là où color-mix() manque (Safari avant 16.2), les teintes retombent sur le fond surélevé.
  • Pas de rendu serveur du calendrier lui-même : importer les paquets ne touche ni document ni window, et le calendrier est créé dans le navigateur.