Merge branch 'master' of github.com:react-native-community/react-native-hooks

Author: Dabit

README.md

@@ -21,6 +21,7 @@ yarn add react-native-hooks
 ## API
 - [useAccessibilityInfo](https://github.com/react-native-community/react-native-hooks#useaccessibilityinfo)
 - [useAppState](https://github.com/react-native-community/react-native-hooks#useappstate)
+- [useBackHandler](https://github.com/react-native-community/react-native-hooks#usebackhandler)
 - [useCameraRoll](https://github.com/react-native-community/react-native-hooks#usecameraroll)
 - [useClipboard](https://github.com/react-native-community/react-native-hooks#useclipboard)
 - [useDimensions](https://github.com/react-native-community/react-native-hooks#usedimensions)
@@ -45,6 +46,21 @@ import { useAppState } from 'react-native-hooks'
 const currentAppState = useAppState()
 ```
 
+### `useBackHandler`
+
+```js
+import { useBackHandler } from 'react-native-hooks'
+
+useBackHandler(() => {
+  if (shouldBeHandledHere) {
+    // handle it
+    return true
+  }
+  // let the default thing happen
+  return false
+})
+```
+
 ### `useCameraRoll`
 
 ```js

index.js

@@ -1,5 +1,6 @@
 import useDimensions from './lib/useDimensions'
 import useAppState from './lib/useAppState'
+import useBackHandler from './lib/useBackHandler'
 import useCameraRoll from './lib/useCameraRoll'
 import useClipboard from './lib/useClipboard'
 import useAccessibilityInfo from './lib/useAccessibilityInfo'
@@ -11,6 +12,7 @@ import useLayout from './lib/useLayout'
 export {
   useDimensions,
   useAppState,
+  useBackHandler,
   useCameraRoll,
   useClipboard,
   useAccessibilityInfo,

lib/useAppState.js

@@ -1,9 +1,9 @@
 import React, { useEffect, useState } from 'react'
 import { AppState } from 'react-native'
 
-const currentState = AppState.currentState
-
+// https://github.com/facebook/react-native/issues/18836
 export default () => {
+  const currentState = AppState.currentState
   const [appState, setAppState] = useState(currentState)
 
   function onChange (newState) {
@@ -19,4 +19,4 @@ export default () => {
   })
 
   return appState
-}
+}

lib/useBackHandler.js

@@ -0,0 +1,13 @@
+import React, { useEffect, useState } from 'react'
+import { BackHandler } from 'react-native'
+
+
+export default (handler) => {
+  useEffect(() => {
+    BackHandler.addEventListener('hardwareBackPress', handler)
+
+    return () => {
+      BackHandler.removeEventListener('hardwareBackPress', handler)
+    }
+  })
+}