Add onSearchButtonPress prop to the headerSearchBarOptions (#1265)

Co-authored-by: Satyajit Sahoo <satyajit.happy@gmail.com>

Author: Steve0929

versioned_docs/version-6.x/native-stack-navigator.md

@@ -376,6 +376,22 @@ A callback that gets called when search bar has lost focus.
 
 A callback that gets called when the cancel button is pressed.
 
+##### `onSearchButtonPress`
+
+A callback that gets called when the search button is pressed.
+
+```js
+const [search, setSearch] = React.useState('');
+
+React.useLayoutEffect(() => {
+  navigation.setOptions({
+    headerSearchBarOptions: {
+      onSearchButtonPress: (event) => setSearch(event?.nativeEvent?.text),
+    },
+  });
+}, [navigation]);
+```
+
 ##### `onChangeText`
 
 A callback that gets called when the text changes. It receives the current text value of the search bar.

versioned_docs/version-7.x/native-stack-navigator.md

@@ -1249,6 +1249,22 @@ A callback that gets called when search bar has lost focus.
 
 A callback that gets called when the cancel button is pressed.
 
+##### `onSearchButtonPress`
+
+A callback that gets called when the search button is pressed.
+
+```js
+const [search, setSearch] = React.useState('');
+
+React.useLayoutEffect(() => {
+  navigation.setOptions({
+    headerSearchBarOptions: {
+      onSearchButtonPress: (event) => setSearch(event?.nativeEvent?.text),
+    },
+  });
+}, [navigation]);
+```
+
 ##### `onChangeText`
 
 A callback that gets called when the text changes. It receives the current text value of the search bar.

versioned_docs/version-8.x/native-stack-navigator.md

@@ -1252,6 +1252,22 @@ A callback that gets called when search bar has lost focus.
 
 A callback that gets called when the cancel button is pressed.
 
+##### `onSearchButtonPress`
+
+A callback that gets called when the search button is pressed.
+
+```js
+const [search, setSearch] = React.useState('');
+
+React.useLayoutEffect(() => {
+  navigation.setOptions({
+    headerSearchBarOptions: {
+      onSearchButtonPress: (event) => setSearch(event?.nativeEvent?.text),
+    },
+  });
+}, [navigation]);
+```
+
 ##### `onChange`
 
 A callback that gets called when the text changes. It receives en event containing the current text value of the search bar.