You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: versioned_docs/version-7.x/native-stack-navigator.md
+38-5Lines changed: 38 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1175,7 +1175,7 @@ Example:
1175
1175
1176
1176
#### `headerSearchBarOptions`
1177
1177
1178
-
Options to render a native search bar on iOS. Search bars are rarely static so normally it is controlled by passing an object to `headerSearchBarOptions` navigation option in the component's body.
1178
+
Options to render a native search bar. Search bars are rarely static so normally it is controlled by passing an object to `headerSearchBarOptions` navigation option in the component's body.
1179
1179
1180
1180
You also need to specify `contentInsetAdjustmentBehavior="automatic"` in your `ScrollView`, `FlatList` etc. If you don't have a `ScrollView`, specify `headerTransparent: false`.
1181
1181
@@ -1202,18 +1202,20 @@ Ref to manipulate the search input imperatively. It contains the following metho
1202
1202
-`setText` - sets the search bar's content to given value
1203
1203
-`clearText` - removes any text present in the search bar input field
1204
1204
-`cancelSearch` - cancel the search and close the search bar
1205
+
-`toggleCancelButton` - depending on passed boolean value, hides or shows cancel button (only supported on iOS)
1205
1206
1206
1207
##### `autoCapitalize`
1207
1208
1208
1209
Controls whether the text is automatically auto-capitalized as it is entered by the user.
1209
1210
Possible values:
1210
1211
1212
+
-`systemDefault`
1211
1213
-`none`
1212
1214
-`words`
1213
1215
-`sentences`
1214
1216
-`characters`
1215
1217
1216
-
Defaults to `sentences`.
1218
+
Defaults to `systemDefault` which is the same as `sentences` on iOS and `none` on Android.
1217
1219
1218
1220
##### `autoFocus`
1219
1221
@@ -1241,7 +1243,7 @@ Only supported on iOS.
1241
1243
1242
1244
The text to be used instead of default `Cancel` button text.
1243
1245
1244
-
Only supported on iOS.
1246
+
Only supported on iOS.**Deprecated** starting from iOS 26.
1245
1247
1246
1248
##### `disableBackButtonOverride`
1247
1249
@@ -1251,7 +1253,9 @@ Only supported on Android.
1251
1253
1252
1254
##### `hideNavigationBar`
1253
1255
1254
-
Boolean indicating whether to hide the navigation bar during searching. Defaults to `true`.
1256
+
Boolean indicating whether to hide the navigation bar during searching.
1257
+
1258
+
If left unset, system default is used.
1255
1259
1256
1260
Only supported on iOS.
1257
1261
@@ -1276,7 +1280,36 @@ Only supported on Android.
1276
1280
1277
1281
##### `obscureBackground`
1278
1282
1279
-
Boolean indicating whether to obscure the underlying content with semi-transparent overlay. Defaults to `true`.
1283
+
Boolean indicating whether to obscure the underlying content with semi-transparent overlay.
1284
+
1285
+
If left unset, system default is used.
1286
+
1287
+
Only supported on iOS.
1288
+
1289
+
##### `placement`
1290
+
1291
+
Controls preferred placement of the search bar. Defaults to `automatic`.
1292
+
1293
+
Supported values:
1294
+
1295
+
-`automatic`
1296
+
-`stacked`
1297
+
-`inline` (**deprecated** starting from iOS 26, it is mapped to `integrated`)
1298
+
-`integrated` (available starting from iOS 26, on prior versions it is mapped to `inline`)
1299
+
-`integratedButton` (available starting from iOS 26, on prior versions it is mapped to `inline`)
1300
+
-`integratedCentered` (available starting from iOS 26, on prior versions it is mapped to `inline`)
1301
+
1302
+
Only supported on iOS.
1303
+
1304
+
##### `allowToolbarIntegration`
1305
+
1306
+
Boolean indicating whether the system can place the search bar among other toolbar items on iPhone.
1307
+
1308
+
Set this prop to `false` to prevent the search bar from appearing in the toolbar when `placement` is `automatic`, `integrated`, `integratedButton` or `integratedCentered`.
1309
+
1310
+
Defaults to `true`. If `placement` is set to `stacked`, the value of this prop will be overridden with `false`.
0 commit comments