initialView
La vue que montre le calendrier à sa création.
| Type | string |
|---|---|
| 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é dans | packages/core/src/kernel.ts |
Ce qu’elle fait
Section intitulée « Ce qu’elle fait »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' });import { Component, signal } from '@angular/core';import { DZ_CALENDAR } from '@dzcalendar/angular';import '@dzcalendar/dom/list';
@Component({ selector: 'app-agenda', imports: [DZ_CALENDAR], template: ` <dz-calendar timeZone="Europe/Paris" locale="fr-FR" [(view)]="view" [options]="{ headerToolbar: { start: 'prev,next today', center: 'title', end: 'dayGridMonth,timeGridWeek,listWeek' } }" /> <p>Vue : {{ view() }}</p>`,})export class Agenda { // La première vue ; elle suit ensuite le choix de la personne (bidirectionnel). readonly view = signal<string | undefined>('dayGridMonth');}import { DzCalendar } from '@dzcalendar/react';import '@dzcalendar/dom/list';
export function Agenda() { return ( <DzCalendar timeZone="Europe/Paris" locale="fr-FR" defaultView="dayGridMonth" headerToolbar={{ start: 'prev,next today', center: 'title', end: 'dayGridMonth,timeGridWeek,listWeek' }} /> );}// Contrôlée à la place : view={view} onViewChange={setView}<script setup lang="ts">import { ref } from 'vue';import { DzCalendar } from '@dzcalendar/vue';import '@dzcalendar/dom/list';
const view = ref('dayGridMonth');</script>
<template> <DzCalendar time-zone="Europe/Paris" locale="fr-FR" v-model:view="view" :options="{ headerToolbar: { start: 'prev,next today', center: 'title', end: 'dayGridMonth,timeGridWeek,listWeek' } }" /></template>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.
Démo en direct
Section intitulée « Démo en direct »Le calendrier s’ouvre sur le mois ; l’en-tête passe à la semaine et à la liste.
Voir aussi
Section intitulée « Voir aussi »headerToolbar— où vont les boutons des vues.events— ce que montrent les vues.- Vues — vues personnalisées, durées, jours masqués.