Kurs React Native · Moduł 13: Natywne API
expo-contacts - Kontakty użytkownika
W tej lekcji5
Witaj w Skarbcu Kontaktów! Nauczysz się integrować aplikację z kontaktami telefonu.
Instalacja
npx expo install expo-contactsUprawnienia i pobieranie kontaktów
import * as Contacts from 'expo-contacts';
async function getContacts() {
const { status } = await Contacts.requestPermissionsAsync();
if (status !== 'granted') {
Alert.alert('Brak uprawnień', 'Włącz dostęp do kontaktów');
return [];
}
const { data } = await Contacts.getContactsAsync({
fields: [
Contacts.Fields.Name,
Contacts.Fields.PhoneNumbers,
Contacts.Fields.Emails,
Contacts.Fields.Image,
],
});
return data;
}Wyszukiwanie kontaktów
async function searchContacts(query: string) {
const { data } = await Contacts.getContactsAsync({
name: query, // Filtrowanie po nazwie
fields: [Contacts.Fields.Name, Contacts.Fields.PhoneNumbers],
});
return data;
}Dodawanie kontaktu
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 };
}Kod do tej lekcji: App.tsx
import React, { useState, useEffect } from 'react';
import { View, Text, FlatList, StyleSheet } from 'react-native';
import * as Contacts from 'expo-contacts';
// Hook zwracający kontakty z telefonu użytkownika
function useContacts() {
const [contacts, setContacts] = useState<Contacts.Contact[]>([]);
const [loading, setLoading] = useState(true);
const [permission, setPermission] = useState(false);
useEffect(() => {
(async () => {
// TODO: poproś o uprawnienia: const { status } = await Contacts.requestPermissionsAsync();
// TODO: ustaw setPermission(status === 'granted');
// TODO: jeśli status === 'granted', pobierz kontakty:
// const { data } = await Contacts.getContactsAsync({
// fields: [Contacts.Fields.Name, Contacts.Fields.PhoneNumbers],
// });
// następnie wywołaj 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}>Ładowanie kontaktów...</Text>
</View>
);
}
return (
<View style={styles.screen}>
<Text style={styles.title}>Kontakty Atlantydy</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,
},
});Hasła z dokumentacji w tej lekcji
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Jak zainstalować expo-contacts?
2. Jak poprosić o uprawnienia do kontaktów?
To 2 z 4 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Układanie w poziomie
Ułóż pobieranie kontaktów:
- Edytor kodu
Uzupełnij kod useContacts.