Cours React Native · Module 13: API natives

expo-contacts - Contacts de l'utilisateur

2 min de lecture ·
Dans cette leçon5

Bienvenue dans le Coffre des Contacts ! Tu vas apprendre à intégrer l'application avec les contacts du téléphone.

Installation

npx expo install expo-contacts

Permissions et récupération des contacts

import * as Contacts from 'expo-contacts';

async function getContacts() {
  const { status } = await Contacts.requestPermissionsAsync();

  if (status !== 'granted') {
    Alert.alert('Pas de permissions', 'Active l\'accès aux contacts');
    return [];
  }

  const { data } = await Contacts.getContactsAsync({
    fields: [
      Contacts.Fields.Name,
      Contacts.Fields.PhoneNumbers,
      Contacts.Fields.Emails,
      Contacts.Fields.Image,
    ],
  });

  return data;
}

Recherche de contacts

async function searchContacts(query: string) {
  const { data } = await Contacts.getContactsAsync({
    name: query, // Filtrer par nom
    fields: [Contacts.Fields.Name, Contacts.Fields.PhoneNumbers],
  });
  return data;
}

Ajouter un contact

async function addContact(name: string, phone: string, email: string) {
  const contact = {
    [Contacts.Fields.FirstName]: name.split(' ')[0],
    [Contacts.Fields.LastName]: name.split(' ')[1] || '',
    [Contacts.Fields.PhoneNumbers]: [
      { label: 'mobile', number: phone },
    ],
    [Contacts.Fields.Emails]: [
      { label: 'work', email: email },
    ],
  };

  const contactId = await Contacts.addContactAsync(contact);
  return contactId;
}

Hook useContacts

function useContacts() {
  const [contacts, setContacts] = useState<Contacts.Contact[]>([]);
  const [loading, setLoading] = useState(true);
  const [permission, setPermission] = useState(false);

  useEffect(() => {
    (async () => {
      const { status } = await Contacts.requestPermissionsAsync();
      setPermission(status === 'granted');

      if (status === 'granted') {
        const { data } = await Contacts.getContactsAsync({
          fields: [Contacts.Fields.Name, Contacts.Fields.PhoneNumbers],
        });
        setContacts(data);
      }
      setLoading(false);
    })();
  }, []);

  return { contacts, loading, permission };
}
Code de cette leçon : App.tsx
import React, { useState, useEffect } from 'react';
import { View, Text, FlatList, StyleSheet } from 'react-native';
import * as Contacts from 'expo-contacts';

// Hook qui renvoie les contacts du téléphone de l'utilisateur
function useContacts() {
  const [contacts, setContacts] = useState<Contacts.Contact[]>([]);
  const [loading, setLoading] = useState(true);
  const [permission, setPermission] = useState(false);

  useEffect(() => {
    (async () => {
      // TODO : demander les autorisations : const { status } = await Contacts.requestPermissionsAsync();
      // TODO : appeler setPermission(status === 'granted');

      // TODO : si status === 'granted', récupérer les contacts :
      //   const { data } = await Contacts.getContactsAsync({
      //     fields: [Contacts.Fields.Name, Contacts.Fields.PhoneNumbers],
      //   });
      //   puis appeler setContacts(data);

      setLoading(false);
    })();
  }, []);

  return { contacts, loading, permission };
}

export default function App() {
  const { contacts, loading } = useContacts();

  if (loading) {
    return (
      <View style={styles.screen}>
        <Text style={styles.title}>Chargement des contacts...</Text>
      </View>
    );
  }

  return (
    <View style={styles.screen}>
      <Text style={styles.title}>Contacts de l'Atlantide</Text>
      <FlatList
        data={contacts}
        keyExtractor={(item) => item.id ?? Math.random().toString()}
        renderItem={({ item }) => <Text style={styles.item}>{item.name}</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-contacts ?

  2. 2. Comment demande-t-on les permissions pour les contacts ?

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

Tâches pratiques dans le jeu

  • Tri horizontal

    Ordonne la récupération des contacts :

  • Éditeur de code

    Complète le code de useContacts.

  1. QuestionInstaller les contacts
  2. QuestionrequestPermissionsAsync
  3. Remets dans l'ordregetContactsAsync
  4. QuestionContacts.Fields
  5. QuestionaddContactAsync
  6. Exercice de codeHook des contacts

Articles utiles