BackHandler

Nieoficjalne Tłumaczenie Beta

Ta strona została przetłumaczona przez PageTurner AI (beta). Nie jest oficjalnie zatwierdzona przez projekt. Znalazłeś błąd? Zgłoś problem →

API BackHandler wykrywa naciśnięcia sprzętowego przycisku wstecz, umożliwia rejestrację słuchaczy zdarzeń dla systemowej akcji "wstecz" oraz pozwala kontrolować reakcję aplikacji. Działa wyłącznie na platformie Android.

Subskrypcje zdarzeń są wywoływane w odwrotnej kolejności (tzn. ostatnio zarejestrowana subskrypcja jest wywoływana jako pierwsza).

• Jeśli jakakolwiek subskrypcja zwróci true, wcześniej zarejestrowane subskrypcje nie zostaną wywołane.

• Jeśli żadna subskrypcja nie zwróci true lub nie ma zarejestrowanych subskrypcji, system programowo wywoła domyślną funkcję przycisku wstecz, aby zamknąć aplikację.

Uwaga dla użytkowników modali: Jeśli twoja aplikacja wyświetla otwarty Modal, BackHandler nie opublikuje żadnych zdarzeń (zobacz dokumentację Modal).

Wzorzec użycia

tsx

const subscription = BackHandler.addEventListener(
  'hardwareBackPress',
  function () {
    /**
     * this.onMainScreen and this.goBack are just examples,
     * you need to use your own implementation here.
     *
     * Typically you would use the navigator here to go to the last state.
     */

    if (!this.onMainScreen()) {
      this.goBack();
      /**
       * When true is returned the event will not be bubbled up
       * & no other back action will execute
       */
      return true;
    }
    /**
     * Returning false will let the event to bubble up & let other event listeners
     * or the system's default back action to be executed.
     */
    return false;
  },
);

// Unsubscribe the listener on unmount
subscription.remove();

Przykład

Poniższy przykład implementuje scenariusz potwierdzania wyjścia z aplikacji:

BackHandler.addEventListener tworzy słuchacz zdarzeń i zwraca obiekt NativeEventSubscription, który powinien zostać usunięty metodą NativeEventSubscription.remove.

Użycie z React Navigation

Jeśli używasz React Navigation do nawigacji między ekranami, możesz skorzystać z ich przewodnika: Niestandardowe zachowanie przycisku wstecz na Androidzie

Hook BackHandlera

React Native Hooks udostępnia poręczny hook useBackHandler, który upraszcza konfigurację słuchaczy zdarzeń.

---

Dokumentacja

Metody

addEventListener()

tsx

static addEventListener(
  eventName: BackPressEventName,
  handler: () => boolean | null | undefined,
): NativeEventSubscription;

---

exitApp()

tsx

static exitApp();