Aller au contenu

timeGrid

Les heures des vues semaine et jour : lesquelles sont dessinées, comment elles sont marquées, et comment se dessine un changement d’heure.

TypeOmit<TimeGridOptions, 'displayZone' | 'businessHours' | 'availableSlots' | 'resources' | 'resourceGroups'>
Par défautnon défini
Modifiable en direct (update())Oui
Déclaré danspackages/core/src/kernel.ts

Fusionnée clé par clé avec update({ timeGrid }) : donnez ce qui change, le reste reste ; des valeurs égales ne changent rien.

  • slotMin, slotMax : la première heure dessinée et la fin de la dernière (une journée d’ouverture de 08:00 à 18:00). Les événements entièrement en dehors ne sont pas dessinés — signalé une fois (events-not-drawn).
  • slotMinutes, labelMinutes : un repère toutes les slotMinutes dans la gouttière, étiqueté toutes les labelMinutes (un multiple). Seuls les repères étiquetés montrent un texte ; chaque repère porte data-time (un test, un hook, les rangées de slotLane).
  • minEventMinutes : la hauteur minimale d’un événement, pour qu’un appel de cinq minutes reste lisible.
  • axis : 'wall' garde les rangées de tous les jours alignées — lors d’un changement d’heure, l’heure qui n’existe pas est une bande qui le dit, et l’heure répétée est marquée par une bande (ses deux lectures partagent ses rangées) ; 'elapsed' dessine le temps réel à l’échelle : l’heure répétée apparaît deux fois et un jour de 25 heures est plus haut.

La hauteur d’une heure vient de density (48, 72 ou 96 px) ; les lignes de la grille restent horaires. slotMinutes et labelMinutes sont des minutes entières de 1 à 1440, et slotMin/slotMax respectent 0 ≤ slotMin < slotMax ≤ 24 h : toute autre valeur lève une RangeError à createCalendar ou update(), avant tout changement.

TypeAxisMode — "wall" | "elapsed"
Par défaut'wall'
Modifiable en direct (update())Oui
Déclaré danspackages/core/src/views/timegrid.ts

'wall' (par défaut) : les rangées alignées d’un jour à l’autre, l’heure sautée et l’heure répétée marquées par des bandes. 'elapsed' : le temps réel à l’échelle — le jour de 25 heures de Paris, l’heure répétée apparaît deux fois et la nuit est plus haute d’une heure.

Typenumber
Par défaut60
Modifiable en direct (update())Oui
Déclaré danspackages/core/src/views/timegrid.ts

Une étiquette toutes les tant de minutes de l’horloge ; un multiple de slotMinutes tombe sur un repère.

Typenumber
Par défaut15
Modifiable en direct (update())Oui
Déclaré danspackages/core/src/views/timegrid.ts

La hauteur minimale d’un événement : un plus court est dessiné à cette hauteur, son heure réelle inchangée.

TypeDurationLike
Par défaut'PT24H'
Modifiable en direct (update())Oui
Déclaré danspackages/core/src/views/timegrid.ts

La fin de la dernière heure dessinée, en durée depuis minuit, jusqu’à 24 heures ('PT18H', { hours: 18 }).

TypeDurationLike
Par défaut'PT0H'
Modifiable en direct (update())Oui
Déclaré danspackages/core/src/views/timegrid.ts

La première heure dessinée, en durée depuis minuit ('PT8H') ; les heures d’avant ne sont pas dessinées et scrollTime compte à partir d’ici.

Typenumber
Par défaut60
Modifiable en direct (update())Oui
Déclaré danspackages/core/src/views/timegrid.ts

Un repère toutes les tant de minutes dans la gouttière : chacun porte data-time et reçoit son hooks.slotLabel et sa rangée slotLane ; seuls les repères étiquetés montrent un texte. Les lignes de la grille restent horaires.

import { createCalendar } from '@dzcalendar/dom';
const calendar = createCalendar(element, {
timeZone: 'Europe/Paris',
timeGrid: { slotMin: 'PT8H', slotMax: 'PT18H', slotMinutes: 15, labelMinutes: 30 },
});
// Later: real time to scale, the rest unchanged.
calendar.update({ timeGrid: { axis: 'elapsed' } });

En Angular et en Vue elle va dans options (axis est aussi une entrée en Angular et une prop en Vue) ; en React c’est une prop (et axis en est une à part).

La journée de 08:00 à 18:00, une étiquette chaque demi-heure (les repères de 15 minutes ne portent pas de texte).