Cours React Native · Module 13: API natives
expo-contacts - Contacts de l'utilisateur
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-contactsPermissions 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. Comment installe-t-on expo-contacts ?
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.