Aller au contenu

selectable

Permet à une personne de sélectionner une plage vide — pour la réserver, pour la bloquer.

Typeboolean
Par défautfalse
Modifiable en direct (update())Oui
Déclaré danspackages/dom/src/settings.ts

Avec selectable: true, glisser sur une plage vide la sélectionne : des heures dans une grille horaire, des jours dans un mois. Au clavier, Entrée sur une case la sélectionne et Maj+flèches l’agrandissent (annoncé au fur et à mesure) ; Entrée la donne à l’application.

onSelect(selection) l’entend : { start, end, allDay, resourceId? }, le début et la fin dans le fuseau du calendrier (des ZonedDateTime), ou des dates pour des journées entières — la fin étant alors le lendemain du dernier jour. Sur un écran tactile, un appui sur une plage vide sélectionne une case, avec des poignées pour l’étirer. Entrée (ou Espace) sur une case est aussi un clic de date. La sélection reste dessinée jusqu’à un clic ailleurs, Échap ou une autre période (onUnselect) ; calendar.select(selection | null) en montre ou en efface une depuis votre code. Un clic de souris ne sélectionne pas : c’est un clic de date (onDateClick).

import { createCalendar } from '@dzcalendar/dom';
createCalendar(element, {
timeZone: 'Europe/Paris',
selectable: true,
onSelect: ({ start, end }) => console.log(`book ${start.toString()} → ${end.toString()}`),
});

Dans les frameworks, c’est une entrée : selectable en Angular (et le double sens [(selection)]), selectable en React (avec selection et onSelectionChange), selectable en Vue (avec v-model:selection).

Glissez sur des heures vides pour les sélectionner.