Kurs React Native · Moduł 13: Natywne API

expo-contacts - Kontakty użytkownika

2 min czytania ·
W tej lekcji5

Witaj w Skarbcu Kontaktów! Nauczysz się integrować aplikację z kontaktami telefonu.

Instalacja

npx expo install expo-contacts

Uprawnienia 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. 1. Jak zainstalować expo-contacts?

  2. 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.

  1. PytanieInstalacja contacts
  2. PytanierequestPermissionsAsync
  3. Ułóż w kolejnościgetContactsAsync
  4. PytanieContacts.Fields
  5. PytanieaddContactAsync
  6. Zadanie z kodemContacts hook

Przydatne artykuły