Aller au contenu

onProblem

Écoute ce que le calendrier n’a pas pu faire comme demandé — trouvé en dessinant, pas dans les données.

Type(problem: CalendarProblem) => void
Par défautnon défini
Modifiable en direct (update())Oui
Déclaré danspackages/dom/src/settings.ts

Elle reçoit { code, detail, element? } — detail dans la langue du calendrier (le problem des messages), code pour les programmes :

  • events-not-drawn : des événements que la vue ne peut pas montrer — des événements d’une journée entière dans une grille horaire sans sa rangée « toute la journée », des événements horaires entièrement hors de slotMin–slotMax ;
  • host-no-height : le calendrier n’a pas de hauteur à lui (un hôte display: inline, ou --dz-height: 100% sans ancêtre de hauteur donnée) et grandit avec son contenu ;
  • zone-from-browser : aucun timeZone donné, celui de l’appareil est utilisé ;
  • too-many-occurrences : une série a plus de 2 000 occurrences dans ce qui est montré (une règle chaque minute, une année) : les 2 000 premières sont dessinées.

Chacun est dit une fois par code, vue et raison (une série pour le dernier), et de nouveau s’il revient après être parti. Sans onProblem, chaque code est dit une fois dans la console. Une mauvaise donnée — un événement illisible — n’est pas ici : elle est dans calendar.kernel.getProblems() et onSource.

import { createCalendar } from '@dzcalendar/dom';
createCalendar(element, {
timeZone: 'Europe/Paris',
onProblem: (problem) => monitoring.report(`calendar ${problem.code}: ${problem.detail}`),
});
declare const monitoring: { report(message: string): void };

Dans les frameworks, c’est une sortie : (problem) en Angular, onProblem en React, @problem en Vue. Angular les dit aussi dans la console.