Skip to content

Commit 12270d1

Browse files
committed
chore: Update docs about headerBackButtonDisplayMode and headerBackTitle
1 parent cff44bd commit 12270d1

File tree

1 file changed

+13
-4
lines changed

1 file changed

+13
-4
lines changed

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

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -174,7 +174,9 @@ This will have no effect on the first screen in the stack.
174174

175175
#### `headerBackTitle`
176176

177-
Title string used by the back button on iOS. Defaults to the previous scene's title, or "Back" if there's not enough space. Use `headerBackButtonDisplayMode` to customize the behavior.
177+
Title string used by the back button on iOS. Defaults to the previous scene's title.
178+
179+
Use `headerBackButtonDisplayMode: "minimal"` to hide it.
178180

179181
Only supported on iOS.
180182

@@ -185,10 +187,17 @@ Only supported on iOS.
185187
How the back button displays icon and title.
186188

187189
Supported values:
190+
- "default" - Displays one of the following depending on the available space: previous screen's title, generic title (e.g. 'Back') or no title (only icon).
191+
- "generic" – Displays one of the following depending on the available space: generic title (e.g. 'Back') or no title (only icon).
192+
- "minimal" – Always displays only the icon without a title.
193+
194+
The space-aware behavior is disabled when:
195+
- The iOS version is 13 or lower
196+
- Custom back title is set (e.g. with `headerBackTitle`)
197+
- Custom font family or size is set (e.g. with `headerBackTitleStyle`)
198+
- Back button menu is disabled (e.g. with `headerBackButtonMenuEnabled`)
188199

189-
- `default`: Displays one of the following depending on the available space: previous screen's title, generic title (e.g. 'Back') or no title (only icon).
190-
- `generic`: Displays one of the following depending on the available space: generic title (e.g. 'Back') or no title (only icon). iOS >= 14 only, falls back to "default" on older iOS versions.
191-
- `minimal`: Always displays only the icon without a title.
200+
In such cases, a static title and icon are always displayed.
192201

193202
Only supported on iOS.
194203

0 commit comments

Comments
 (0)