Cours React Native · Module 13: API natives

expo-calendar - Calendrier et événements

2 min de lecture ·
Dans cette leçon5

Intègre l'application avec le calendrier de l'utilisateur !

Installation

npx expo install expo-calendar

Récupérer les calendriers

import * as Calendar from 'expo-calendar';

async function getCalendars() {
  const { status } = await Calendar.requestCalendarPermissionsAsync();

  if (status !== 'granted') {
    Alert.alert('Pas de permissions pour le calendrier');
    return [];
  }

  const calendars = await Calendar.getCalendarsAsync(Calendar.EntityTypes.EVENT);
  return calendars;
}

Récupérer les événements

async function getEvents(calendarId: string, startDate: Date, endDate: Date) {
  const events = await Calendar.getEventsAsync(
    [calendarId],
    startDate,
    endDate
  );
  return events;
}

// Exemple : événements des 7 prochains jours
const now = new Date();
const nextWeek = new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000);
const events = await getEvents('calendar-id', now, nextWeek);

Créer un événement

async function createEvent(
  calendarId: string,
  title: string,
  startDate: Date,
  endDate: Date,
  location?: string
) {
  const eventId = await Calendar.createEventAsync(calendarId, {
    title,
    startDate,
    endDate,
    location,
    notes: 'Créé par Atlantis',
    alarms: [{ relativeOffset: -30 }], // Rappel 30 min avant
  });
  return eventId;
}

Créer un calendrier

async function createCalendar() {
  const defaultCalendarSource = Platform.OS === 'ios'
    ? await Calendar.getDefaultCalendarAsync()
    : { isLocalAccount: true, name: 'Expo Calendar' };

  const calendarId = await Calendar.createCalendarAsync({
    title: 'Atlantis Events',
    color: '#1a5276',
    entityType: Calendar.EntityTypes.EVENT,
    sourceId: defaultCalendarSource.id,
    source: defaultCalendarSource,
    name: 'atlantisCalendar',
    ownerAccount: 'personal',
    accessLevel: Calendar.CalendarAccessLevel.OWNER,
  });

  return calendarId;
}
Code de cette leçon : App.tsx
import React, { useState, useEffect } from 'react';
import { View, Text, Button, StyleSheet } from 'react-native';
import * as Calendar from 'expo-calendar';

// Hook pour gérer le calendrier de l'utilisateur
function useCalendar() {
  const [events, setEvents] = useState<Calendar.Event[]>([]);
  const [calendarId, setCalendarId] = useState<string | null>(null);

  useEffect(() => {
    (async () => {
      // TODO : demander les autorisations du calendrier :
      //   const { status } = await Calendar.requestCalendarPermissionsAsync();
      //   if (status !== 'granted') return;

      // TODO : récupérer les calendriers d'événements :
      //   const calendars = await Calendar.getCalendarsAsync(Calendar.EntityTypes.EVENT);
      //   if (calendars.length > 0) setCalendarId(calendars[0].id);
    })();
  }, []);

  async function loadEvents() {
    if (!calendarId) return;
    const now = new Date();
    const nextWeek = new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000);

    // TODO : récupérer les événements de la semaine prochaine :
    //   const data = await Calendar.getEventsAsync([calendarId], now, nextWeek);
    //   setEvents(data);
  }

  return { events, calendarId, loadEvents };
}

export default function App() {
  const { events, loadEvents } = useCalendar();

  return (
    <View style={styles.screen}>
      <Text style={styles.title}>Calendrier de l'Atlantide</Text>
      <Button title="Charger les événements" onPress={loadEvents} />
      {events.map((event) => (
        <Text key={event.id} style={styles.item}>{event.title}</Text>
      ))}
    </View>
  );
}

const styles = StyleSheet.create({
  screen: {
    flex: 1,
    padding: 24,
    backgroundColor: '#1a5276',
  },
  title: {
    fontSize: 22,
    color: '#fff',
    fontWeight: '600',
    marginBottom: 16,
  },
  item: {
    fontSize: 16,
    color: '#d6eaf8',
    paddingVertical: 6,
  },
});

Entrées de la documentation utilisées dans cette leçon

Tu as repéré une erreur dans cette leçon ?

Teste tes connaissances

Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.

  1. 1. Comment installe-t-on expo-calendar ?

  2. 2. Comment récupère-t-on la liste des calendriers ?

Voici 2 des 4 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Clique dans l'ordre

    Clique sur les éléments pour récupérer les événements :

  • Éditeur de code

    Complète le code de useCalendar.

  1. QuestionInstaller le calendrier
  2. QuestiongetCalendarsAsync
  3. Clique dans l'ordregetEventsAsync
  4. QuestioncreateEventAsync
  5. QuestionRappels d'événement
  6. Exercice de codeHook du calendrier

Articles utiles