Aller au contenu

Sélection

Une sélection, c’est une plage de temps libre qu’une personne délimite — pour la réserver, la bloquer, y commencer un événement. Le calendrier la dessine et vous dit ce qu’elle couvre ; il ne crée rien. Ce que la sélection devient, c’est à vous d’en décider. Ce guide explique comment en faire une, comment s’en servir, et comment la distinguer d’un clic.

Activez-la avec selectable. Rien d’autre n’est nécessaire :

  • À la souris ou au stylet, appuyez sur un temps libre et glissez. Dans une grille horaire, cela sélectionne des heures ; dans un mois, des jours entiers. Un simple clic n’est pas une sélection : c’est un clic sur une date, décrit plus bas. Un appui sur un événement concerne l’événement (son clic, son glissement), jamais le temps qui se trouve derrière.
  • Au doigt, un tap sur un temps libre sélectionne un créneau, avec une poignée à chaque bout pour l’étirer. Un doigt qui part d’une zone vide fait défiler la page, comme il se doit : les poignées sont la manière d’étendre une sélection sur un écran tactile.
  • Au clavier, une section à part plus bas.

Les heures s’alignent sur un pas, snapMinutes (15 par défaut), le même que celui des glissements, des redimensionnements et des flèches. Dans un mois, ce sont des jours entiers quoi qu’il dise.

Essayez : glissez sur des heures libres ; cliquez sur un temps libre pour l’effacer.

Quand une personne termine une sélection, onSelect la reçoit : { start, end, allDay, resourceId? }. Une sélection horaire porte des ZonedDateTime dans le fuseau du calendrier ; une sélection sur des jours porte des dates, le end étant le jour suivant le dernier — la même convention qu’un événement sur la journée, si bien que la sélection se passe telle quelle à event.create.

La sélection reste dessinée pendant que vous décidez de ce qu’on en fait. Effacez-la quand vous avez fini : en JavaScript pur calendar.select(null) ; en Angular, React et Vue en remettant selection, la liaison bidirectionnelle, à null, depuis onSelect même si vous voulez.

import { createCalendar } from '@dzcalendar/dom';
const calendar = createCalendar(element, {
timeZone: 'Europe/Paris',
selectable: true,
snapMinutes: 30,
onSelect: (selection) => {
const title = prompt('Titre ?');
if (title) {
calendar.run({
type: 'event.create',
event: { title, start: selection.start, end: selection.end, allDay: selection.allDay },
});
}
calendar.select(null);
},
});

Deux précisions utiles :

  • onSelect entend une personne, pas votre code. Une sélection que vous montrez avec calendar.select(selection) est dessinée, sans être redite.
  • onUnselect entend la sélection disparaître d’elle-même : un clic sur un temps libre du calendrier ou n’importe où en dehors, Échap, un passage à une autre période ou une autre vue, un nouveau glissement. Il ne vous entend pas l’effacer. Un formulaire à vous, à côté du calendrier, garde la sélection le temps qu’on le remplisse s’il porte data-dz-keep-selection. Servez-vous-en pour fermer un formulaire ouvert pour la sélection — voir onUnselect ; la liaison bidirectionnelle selection des frameworks passe à null dans les mêmes cas.

Un pointeur glisse ; un clavier n’a rien à glisser, il fait donc grandir la sélection. Le focus dans la grille, dans un calendrier selectable :

  • Entrée ou Espace sur un créneau est un clic sur une date et sélectionne aussi ce créneau, qui arrive alors à onSelect. (Un clic de souris ne sélectionne pas ; le clavier n’ayant pas de glissement, c’est son « tap » qui le fait.)
  • Maj et les flèches font grandir la sélection depuis l’endroit où Maj a commencé. Chaque pas est annoncé à un lecteur d’écran (« Sélection : mercredi 21 octobre, 09:00 à 10:00 »), avec le même pas et les mêmes heures qu’au pointeur.
  • Entrée (ou Espace) donne la sélection à onSelect. Dans un mois, Entrée sur un jour qui contient des événements entre dans ces événements — sauf si une sélection est en cours.
  • Une flèche sans Maj, ou Échap, l’efface (onUnselect ; Échap annonce « Sélection effacée »).

Tout ce que fait le clavier dans le calendrier est dans Clavier et accessibilité.

Quatre gestes peuvent partir d’un temps libre, chacun avec son rappel :

La personne Le calendrier appelle
Clique sur un jour ou un créneau libre onDateClick — { allDay, date, instant?, resourceId? }, rien n’est dessiné
Glisse sur du temps libre, ou tape sur un écran tactile onSelect — une plage, qui reste dessinée
Clique sur un créneau libre que vous avez proposé avec availableSlots onSlotClick — le créneau tel que vous l’avez donné
Choisit « Nouvel événement à … » dans le menu contextuel onCreateRequest — { allDay, start, resourceId? }

Un clic sur une date n’a pas besoin de selectable. Dans une grille horaire, son instant est le début du créneau cliqué, aligné sur snapMinutes : un clic à 10 h 37 dit 10 h 30. Sur un écran tactile, un tap fait les deux : un clic sur une date, puis une sélection d’un créneau.

Un créneau libre est un bouton que vous avez dessiné exprès : quand onSlotClick est donné, un appui dessus est le sien — ni un clic sur une date, ni le début d’un glissement. Sans lui, les créneaux sont seulement montrés, et un appui dessus se comporte comme sur un temps libre.

« Nouvel événement à … » (« Nouvel événement le … » dans un mois) est la manière de commencer un événement au clic droit, à l’appui long ou à la touche Menu. Donnez onCreateRequest et le menu la propose, alignée sur snapMinutes, sur un jour ou à un instant ; c’est un point, là où la sélection est une plage. Les deux peuvent ouvrir le même éditeur.

import { Temporal } from '@dzcalendar/core';
import { createCalendar } from '@dzcalendar/dom';
createCalendar(element, {
timeZone: 'Europe/Paris',
availableSlots: [{ start: Temporal.ZonedDateTime.from('2026-10-21T14:00[Europe/Paris]'), end: Temporal.ZonedDateTime.from('2026-10-21T14:30[Europe/Paris]') }],
onDateClick: (click) => console.log(click.allDay ? `jour ${click.date}` : `temps libre à ${click.instant.toString()}`),
onSlotClick: (slot) => console.log('réserver le créneau de', slot.start.toString()),
});

Une sélection n’est pas tenue par rules ni par businessHours. Ces réglages vérifient ce qu’une personne fait à un événement — le déplacer, le redimensionner, le déposer — et un geste refusé est signalé par onProposalRefused. Sélectionner du temps ne déplace aucun événement : rien n’est donc refusé. Les heures de fermeture sont grisées dans la grille, et on peut tout de même les sélectionner.

Quand une sélection doit respecter une limite, décidez dans onSelect et effacez-la. Celle-ci n’accepte qu’une plage d’une seule journée, dans les heures d’ouverture de businessHours: true (du lundi au vendredi, de 9 h à 17 h) :

import { Temporal } from '@dzcalendar/core';
import { createCalendar } from '@dzcalendar/dom';
const calendar = createCalendar(element, {
timeZone: 'Europe/Paris',
selectable: true,
businessHours: true,
onSelect: ({ start, end }) => {
const open =
start instanceof Temporal.ZonedDateTime &&
end instanceof Temporal.ZonedDateTime &&
start.toPlainDate().equals(end.toPlainDate()) &&
start.dayOfWeek <= 5 &&
start.hour >= 9 &&
end.hour * 60 + end.minute <= 17 * 60;
if (open) return console.log(`réserver ${start.toString()} → ${end.toString()}`);
alert("Hors des heures d'ouverture");
calendar.select(null);
},
});

Pour des réservations, le plus solide est de ne pas laisser sélectionner du tout, mais de proposer les créneaux libres avec availableSlots et d’écouter onSlotClick : seul ce que vous avez proposé peut être choisi, et votre serveur le revérifie avant d’enregistrer. Dans tous les cas, validez aussi côté serveur : une sélection n’est qu’une proposition.

Un événement que la personne crée puis déplace est tenu par les règles comme les autres : voir Glisser-déposer.

calendar.select(selection) dessine une sélection comme si une personne l’avait faite, sans appeler onSelect — pour présélectionner un créneau d’une liste, ou marquer ce dont parle un formulaire. calendar.select(null) l’efface, sans appeler onUnselect. Donnez la même forme que celle d’onSelect :

import { Temporal } from '@dzcalendar/core';
calendar.select({
allDay: false,
start: Temporal.ZonedDateTime.from('2026-10-21T14:00[Europe/Paris]'),
end: Temporal.ZonedDateTime.from('2026-10-21T15:00[Europe/Paris]'),
});

Une sélection appartient à la période où elle a été faite : aller à une autre semaine ou à une autre vue l’efface. Dans les frameworks, la liaison bidirectionnelle selection est la même poignée, en lecture et en écriture.

  • Un mois, ou toute grille de jours : des jours entiers. Glisser du 21 au 23 donne start le 21 et end le 24, allDay: true.
  • Une grille horaire : des heures, alignées sur snapMinutes. Glisser vers le haut ou le bas dans une journée donne une plage de cette journée ; glisser dans la colonne d’un autre jour donne une seule plage, du premier appui au dernier. Glisser jusque dans la rangée « toute la journée » en haut sélectionne des jours entiers.
  • Une vue de ressources : la sélection porte le resourceId de la colonne ou de la ligne où elle a commencé — la frise du Pro fonctionne de même le long de son axe de temps, une ressource par ligne. Lisez-le pour savoir de qui est le temps choisi.
  • La liste et l’année servent à lire, pas à sélectionner du temps.

Une sélection est faite de créneaux de l’horloge murale, lus dans le passage sous le pointeur ; elle a donc la bonne durée un jour de 23 h, de 25 h ou de 23 h 30. Son start et son end portent leur décalage : mesurez-la avec start.until(end) et vous obtenez le temps réel, pas la différence de deux lectures de l’horloge.

Au changement d’heure, la grille de créneaux suit l’horloge murale. À Paris, à 02:00 le dernier dimanche de mars, l’heure 02:00–03:00 n’existe pas : elle est dessinée comme une bande, un pointeur qui s’y trouve vaut 03:00, le premier instant qui la suit, et une sélection de 01:00 à 03:00 dure une heure. Le dernier dimanche d’octobre, 02:00–03:00 a lieu deux fois : la grille ne la dessine qu’une fois, un pointeur qui s’y trouve lit le premier passage, et une sélection qui la traverse contient les deux — de 01:00 à 03:00, elle dure trois heures, son end à 03:00+01:00. Le clavier parcourt les deux passages ; l’axis: 'elapsed' de timeGrid les dessine l’un après l’autre.

Lord Howe, au large de l’Australie, montre la demi-heure : le dimanche 4 octobre 2026, ses horloges passent de 02:00 à 02:30. Avec un snapMinutes d’une heure, un tap à 02:40 sélectionne 02:30–03:00 avec skipped: true — le début du créneau, 02:00, n’existe pas, et la sélection contient toujours l’instant touché. Essayez de glisser à travers 02:00 ce dimanche-là :

La manière dont la grille dessine ces jours est dans Fuseaux horaires.