Aller au contenu

availableSlots

Les créneaux libres qu’une personne peut réserver, dessinés dans les vues semaine et jour.

Typereadonly AvailableSlot[] | null
Par défautnull
Modifiable en direct (update())Oui
Déclaré danspackages/core/src/kernel.ts

Chaque créneau est { start, end } — des Instant ou des ZonedDateTime — et, au besoin, resourceId (seules les colonnes de cette ressource le montrent) et seats (dit à côté de son heure). Ils viennent en général de findSlots (@dzcalendar/slots), qui calcule le temps libre d’un prestataire à partir de ses heures, de ce qui est occupé et des règles de réservation — le même code dans la page et sur le serveur.

Un créneau est dessiné dans sa colonne (dans toutes les colonnes sans resourceId) ; avec onSlotClick, il peut être cliqué (ou atteint au clavier puis Entrée) et le reçoit tel quel — sans lui, les créneaux sont seulement montrés. seats est dit quand c’est un entier de 1 ou plus. findSlots donne { start, end } ; resourceId et seats sont à ajouter par vous (ou par @dzcalendar/pro/slots). Le calendrier ne crée rien : l’application le réserve, et son serveur le vérifie de nouveau (checkSlot) avant d’enregistrer. null : aucun créneau. Un nouveau tableau redessine ; le même tableau ne change rien.

import { Temporal, loadTemporal } from '@dzcalendar/core';
import { createCalendar } from '@dzcalendar/dom';
import { findSlots } from '@dzcalendar/slots';
await loadTemporal();
const { slots } = findSlots({
availability: { timeZone: 'Europe/Paris', weekly: [{ days: [1, 2, 3, 4, 5], from: '09:00', to: '12:00' }] },
duration: 30,
from: Temporal.ZonedDateTime.from('2026-10-19T00:00[Europe/Paris]'),
to: Temporal.ZonedDateTime.from('2026-10-24T00:00[Europe/Paris]'),
busy: [],
});
const calendar = createCalendar(element, {
timeZone: 'Europe/Paris',
availableSlots: slots,
onSlotClick: (slot) => fetch('/api/book', { method: 'POST', body: JSON.stringify({ start: slot.start.toString() }) }),
});
// Later: none.
calendar.update({ availableSlots: null });

Dans les frameworks, c’est une entrée : availableSlots en Angular et en React, available-slots en Vue ; le clic est (slotClick) en Angular, onSlotClick en React, @slot-click en Vue.

Trois créneaux libres le mercredi matin, dessinés parmi les événements.