Skip to content

Commit b8663e6

Browse files
committed
Tweak navigator descriptions
1 parent 9403b40 commit b8663e6

File tree

8 files changed

+40
-12
lines changed

8 files changed

+40
-12
lines changed

versioned_docs/version-7.x/drawer-navigator.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ sidebar_label: Drawer
1818

1919
Drawer Navigator renders a navigation drawer on the side of the screen which can be opened and closed via gestures.
2020

21-
This navigator wraps [`react-native-drawer-layout`](drawer-layout.md) to provide integration with React Navigation. If you want to use the drawer without React Navigation integration, use the library directly instead.
21+
This navigator provides React Navigation integration for [`react-native-drawer-layout`](drawer-layout.md). If you don't need React Navigation integration, use [`react-native-drawer-layout`](drawer-layout.md) directly instead.
2222

2323
## Installation
2424

versioned_docs/version-7.x/material-top-tab-navigator.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ sidebar_label: Material Top Tabs
2626

2727
A material-design themed tab bar on the top of the screen that lets you switch between different routes by tapping the tabs or swiping horizontally.
2828

29-
This navigator wraps [`react-native-tab-view`](tab-view.md) to provide integration with React Navigation. If you want to use the tab view without React Navigation integration, use the library directly instead.
29+
This navigator provides React Navigation integration for [`react-native-tab-view`](tab-view.md). If you don't need React Navigation integration, use [`react-native-tab-view`](tab-view.md) directly instead.
3030

3131
## Installation
3232

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

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,9 +34,16 @@ sidebar_label: Native Stack
3434

3535
Native Stack Navigator provides a way for your app to transition between screens where each new screen is placed on top of a stack.
3636

37-
This navigator uses the native APIs `UINavigationController` on iOS and `Fragment` on Android so that navigation built with `createNativeStackNavigator` will behave exactly the same and have the same performance characteristics as apps built natively on top of those APIs. It also offers basic Web support using [`react-native-web`](https://github.com/necolas/react-native-web).
37+
<details>
38+
<summary>Comparison with [Stack Navigator](stack-navigator.md)</summary>
3839

39-
One thing to keep in mind is that while `@react-navigation/native-stack` offers native performance and exposes native features such as large title on iOS etc., it may not be as customizable as [`@react-navigation/stack`](stack-navigator.md) depending on your needs. So if you need more customization than what's possible in this navigator, consider using `@react-navigation/stack` instead - which is a more customizable JavaScript based implementation.
40+
The Native Stack navigator uses the native APIs `UINavigationController` on iOS and `Fragment` on Android. This means animations and gestures are handled by the platform, resulting in smoother transitions and better performance compared to the JavaScript-based [Stack Navigator](stack-navigator.md).
41+
42+
It also exposes native features such as large titles on iOS, form sheets etc., and offers a more native look and feel out of the box.
43+
44+
However, because it relies on native components, it may not support customizations or behaviors not supported by the underlying platforms.
45+
46+
</details>
4047

4148
## Installation
4249

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

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,16 @@ sidebar_label: Stack
2626

2727
Stack Navigator provides a way for your app to transition between screens where each new screen is placed on top of a stack.
2828

29-
By default the stack navigator is configured to have the familiar iOS and Android look & feel: new screens slide in from the right on iOS, use OS default animation on Android. But the [animations can be customized](#animation-related-options) to match your needs.
29+
<details>
30+
<summary>Comparison with [Native Stack](native-stack-navigator.md)</summary>
3031

31-
One thing to keep in mind is that while `@react-navigation/stack` is extremely customizable, it's implemented in JavaScript. While it runs animations and gestures using natively, the performance may not be as fast as a native implementation. This may not be an issue for a lot of apps, but if you're experiencing performance issues during navigation, consider using [`@react-navigation/native-stack`](native-stack-navigator.md) instead - which uses native navigation primitives.
32+
The Stack navigator is implemented in JavaScript and mimics the familiar iOS and Android look & feel. Since it's a custom implementation, it is extremely customizable.
33+
34+
However, even though it runs animations and gestures with native driver, the performance may not be as good as a native implementation. This may not be an issue for many apps, but [Native Stack Navigator](native-stack-navigator.md) - which uses native navigation primitives - will provide better performance and smoother animations.
35+
36+
In addition, because it is a custom implementation, it may not support all the features and behaviors of the underlying platforms such large titles, form sheets, etc.
37+
38+
</details>
3239

3340
## Installation
3441

versioned_docs/version-8.x/drawer-navigator.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ sidebar_label: Drawer
1818

1919
Drawer Navigator renders a navigation drawer on the side of the screen which can be opened and closed via gestures.
2020

21-
This navigator wraps [`react-native-drawer-layout`](drawer-layout.md) to provide integration with React Navigation. If you want to use the drawer without React Navigation integration, use the library directly instead.
21+
This navigator provides React Navigation integration for [`react-native-drawer-layout`](drawer-layout.md). If you don't need React Navigation integration, use [`react-native-drawer-layout`](drawer-layout.md) directly instead.
2222

2323
## Installation
2424

versioned_docs/version-8.x/material-top-tab-navigator.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ sidebar_label: Material Top Tabs
2626

2727
A material-design themed tab bar on the top of the screen that lets you switch between different routes by tapping the tabs or swiping horizontally.
2828

29-
This navigator wraps [`react-native-tab-view`](tab-view.md) to provide integration with React Navigation. If you want to use the tab view without React Navigation integration, use the library directly instead.
29+
This navigator provides React Navigation integration for [`react-native-tab-view`](tab-view.md). If you don't need React Navigation integration, use [`react-native-tab-view`](tab-view.md) directly instead.
3030

3131
## Installation
3232

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

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,9 +34,16 @@ sidebar_label: Native Stack
3434

3535
Native Stack Navigator provides a way for your app to transition between screens where each new screen is placed on top of a stack.
3636

37-
This navigator uses the native APIs `UINavigationController` on iOS and `Fragment` on Android so that navigation built with `createNativeStackNavigator` will behave exactly the same and have the same performance characteristics as apps built natively on top of those APIs. It also offers basic Web support using [`react-native-web`](https://github.com/necolas/react-native-web).
37+
<details>
38+
<summary>Comparison with [Stack Navigator](stack-navigator.md)</summary>
3839

39-
One thing to keep in mind is that while `@react-navigation/native-stack` offers native performance and exposes native features such as large title on iOS etc., it may not be as customizable as [`@react-navigation/stack`](stack-navigator.md) depending on your needs. So if you need more customization than what's possible in this navigator, consider using `@react-navigation/stack` instead - which is a more customizable JavaScript based implementation.
40+
The Native Stack navigator uses the native APIs `UINavigationController` on iOS and `Fragment` on Android. This means animations and gestures are handled by the platform, resulting in smoother transitions and better performance compared to the JavaScript-based [Stack Navigator](stack-navigator.md).
41+
42+
It also exposes native features such as large titles on iOS, form sheets etc., and offers a more native look and feel out of the box.
43+
44+
However, because it relies on native components, it may not support customizations or behaviors not supported by the underlying platforms.
45+
46+
</details>
4047

4148
## Installation
4249

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

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,16 @@ sidebar_label: Stack
2626

2727
Stack Navigator provides a way for your app to transition between screens where each new screen is placed on top of a stack.
2828

29-
By default the stack navigator is configured to have the familiar iOS and Android look & feel: new screens slide in from the right on iOS, use OS default animation on Android. But the [animations can be customized](#animation-related-options) to match your needs.
29+
<details>
30+
<summary>Comparison with [Native Stack](native-stack-navigator.md)</summary>
3031

31-
One thing to keep in mind is that while `@react-navigation/stack` is extremely customizable, it's implemented in JavaScript. While it runs animations and gestures using natively, the performance may not be as fast as a native implementation. This may not be an issue for a lot of apps, but if you're experiencing performance issues during navigation, consider using [`@react-navigation/native-stack`](native-stack-navigator.md) instead - which uses native navigation primitives.
32+
The Stack navigator is implemented in JavaScript and mimics the familiar iOS and Android look & feel. Since it's a custom implementation, it is extremely customizable.
33+
34+
However, even though it runs animations and gestures with native driver, the performance may not be as good as a native implementation. This may not be an issue for many apps, but [Native Stack Navigator](native-stack-navigator.md) - which uses native navigation primitives - will provide better performance and smoother animations.
35+
36+
In addition, because it is a custom implementation, it may not support all the features and behaviors of the underlying platforms such large titles, form sheets, etc.
37+
38+
</details>
3239

3340
## Installation
3441

0 commit comments

Comments
 (0)