Plugin de service d'événements

Le plugin service d'événements apporte des fonctions avancées de gestion des événements : validation, filtrage et requêtes complexes.

Installation

Le plugin service d'événements fait actuellement partie du paquet @dayflow/core.

import { createEventsPlugin } from '@dayflow/core';

Utilisation

import {
  useCalendarApp,
  DayFlowCalendar,
  createEventsPlugin,
} from '@dayflow/react';

function MyCalendar() {
  const eventsPlugin = createEventsPlugin({
    enableValidation: true,
    maxEventsPerDay: 50,
  });

  const calendar = useCalendarApp({
    views: [
      /* your views */
    ],
    plugins: [eventsPlugin],
  });

  return <DayFlowCalendar calendar={calendar} />;
}

<template>
  <DayFlowCalendar :calendar="calendar" />
</template>

<script setup>
import { DayFlowCalendar, useCalendarApp } from '@dayflow/vue';
import { createEventsPlugin } from '@dayflow/core';

const eventsPlugin = createEventsPlugin({
  enableValidation: true,
  maxEventsPerDay: 50,
});

const calendar = useCalendarApp({
  views: [
    /* your views */
  ],
  plugins: [eventsPlugin],
});
</script>

import { Component } from '@angular/core';
import { DayFlowCalendarModule } from '@dayflow/angular';
import { createEventsPlugin } from '@dayflow/core';

@Component({
  selector: 'app-root',
  standalone: true,
  imports: [DayFlowCalendarModule],
  template: `<dayflow-calendar [calendar]="calendar"></dayflow-calendar>`
})
export class AppComponent {
  eventsPlugin = createEventsPlugin({
    enableValidation: true,
    maxEventsPerDay: 50,
  });

  calendar = {
    views: [
      /* your views */
    ],
    plugins: [this.eventsPlugin]
  };
}

<script>
  import { DayFlowCalendar, useCalendarApp } from '@dayflow/svelte';
  import { createEventsPlugin } from '@dayflow/core';

  const eventsPlugin = createEventsPlugin({
    enableValidation: true,
    maxEventsPerDay: 50,
  });

  const calendar = useCalendarApp({
    views: [
      /* your views */
    ],
    plugins: [eventsPlugin],
  });
</script>

<DayFlowCalendar {calendar} />

Configuration

Propriété	Type	Par défaut	Description
`enableAutoRecalculate`	`boolean`	`true`	Recalcule automatiquement les segments des événements lorsque les dates changent.
`enableValidation`	`boolean`	`true`	Valide les objets événement avant leur ajout ou leur mise à jour.
`maxEventsPerDay`	`number`	`50`	Nombre maximal d'événements autorisés par jour.

API du plugin

Accédez à EventsService pour effectuer des requêtes avancées :

const eventsService = calendar.app.getPlugin<EventsService>('events');

// Get events for a specific day
const events = eventsService.getByDate(new Date());

// Filter events
const workEvents = eventsService.filterEvents(
  allEvents,
  e => e.calendarId === 'work'
);

Méthodes disponibles

getAll() : récupère tous les événements.
getById(id) : recherche un événement précis.
getByDate(date) : récupère les événements d'une date donnée.
getByDateRange(start, end) : récupère les événements d'une plage donnée.
validateEvent(event) : renvoie un tableau des erreurs de validation.