Aller au contenu

initialView

La vue que montre le calendrier à sa création.

Typestring
Par défaut'timeGridWeek' — ou, avec @dzcalendar/dom/base, la première vue dont le rendu est importé
Modifiable en direct (update())Oui, sous le nom view : update({ view: … })
Déclaré danspackages/core/src/kernel.ts

Une vue est une façon de dessiner une période : un mois de cases, une semaine d’heures, une liste. initialView nomme celle qui s’affiche d’abord ; la personne passe ensuite d’une vue à l’autre avec les boutons de l’en-tête, et votre code avec update({ view }).

Les vues intégrées à @dzcalendar/dom :

Nom Ce qu’elle montre
dayGridMonth Le mois, une case par jour
dayGridWeek, dayGridDay Une semaine, un jour, en cases
timeGridWeek La semaine, heure par heure (par défaut)
timeGridDay Un jour, heure par heure

Deux autres familles sont des entrées à part, importées une fois :

Nom Import
listDay, listWeek, listMonth, listYear import '@dzcalendar/dom/list'
multiMonthYear import '@dzcalendar/dom/multimonth'

Les vues par ressource (resourceTimeGridWeek…) et, avec @dzcalendar/pro, les vues timeline sont décrites dans Ressources et timeline. Vos propres vues — quatre jours, les dates d’un congrès — se déclarent avec views et se nomment ici comme les autres.

import { createCalendar } from '@dzcalendar/dom';
import '@dzcalendar/core/recurrence'; // les événements répétés (rrule)
import '@dzcalendar/dom/list';
const calendar = createCalendar(element, {
timeZone: 'Europe/Paris',
locale: 'fr-FR',
initialView: 'dayGridMonth',
headerToolbar: { start: 'prev,next today', center: 'title', end: 'dayGridMonth,timeGridWeek,listWeek' },
});
// Plus tard : une autre vue.
calendar.update({ view: 'listWeek' });

Dans les frameworks, l’option est la vue du composant : [(view)] en Angular, defaultView en React (ou view avec onViewChange, contrôlée), v-model:view en Vue.

Le calendrier s’ouvre sur le mois ; l’en-tête passe à la semaine et à la liste.

  • headerToolbar — où vont les boutons des vues.
  • events — ce que montrent les vues.
  • Vues — vues personnalisées, durées, jours masqués.