docs: document new animation property

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

@@ -313,6 +313,24 @@ You can also specify `{ backgroundColor: 'transparent' }` to make the previous s
 
 Whether transition animation should be enabled the screen. If you set it to `false`, the screen won't animate when pushing or popping. Defaults to `true`.
 
+#### `animation`
+
+How the screen should animate when pushed or popped.
+
+Supported values:
+
+- `default`: use the platform default animation
+- `fade`: fade screen in or out
+- `fade_from_bottom`: fade the new screen from bottom
+- `slide_from_bottom`: slide in the new screen from bottom
+- `slide_from_right`: slide in the new screen from right
+- `slide_from_left`: slide in the new screen from left
+- `none`: don't animate the screen
+
+If `animation` is set, it overrides `cardStyleInterpolator` property.
+
+Only supported on Android and iOS.
+
 #### `animationTypeForReplace`
 
 The type of animation to use when this screen replaces another screen. It takes the following values:

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

@@ -364,6 +364,24 @@ You can also specify `{ backgroundColor: 'transparent' }` to make the previous s
 
 Whether transition animation should be enabled on the screen. If you set it to `false`, the screen won't animate when pushing or popping. Defaults to `true` on iOS and Android, `false` on Web.
 
+#### `animation`
+
+How the screen should animate when pushed or popped.
+
+Supported values:
+
+- `default`: use the platform default animation
+- `fade`: fade screen in or out
+- `fade_from_bottom`: fade the new screen from bottom
+- `slide_from_bottom`: slide in the new screen from bottom
+- `slide_from_right`: slide in the new screen from right
+- `slide_from_left`: slide in the new screen from left
+- `none`: don't animate the screen
+
+If `animation` is set, it overrides `cardStyleInterpolator` property.
+
+Only supported on Android and iOS.
+
 #### `animationTypeForReplace`
 
 The type of animation to use when this screen replaces another screen. It takes the following values:

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

@@ -166,6 +166,24 @@ See [Transparent modals](#transparent-modals) for more details on how to customi
 
 Whether transition animation should be enabled on the screen. If you set it to `false`, the screen won't animate when pushing or popping. Defaults to `true` on iOS and Android, `false` on Web.
 
+#### `animation`
+
+How the screen should animate when pushed or popped.
+
+Supported values:
+
+- `default`: use the platform default animation
+- `fade`: fade screen in or out
+- `fade_from_bottom`: fade the new screen from bottom
+- `slide_from_bottom`: slide in the new screen from bottom
+- `slide_from_right`: slide in the new screen from right
+- `slide_from_left`: slide in the new screen from left
+- `none`: don't animate the screen
+
+If `animation` is set, it overrides `cardStyleInterpolator` property.
+
+Only supported on Android and iOS.
+
 #### `animationTypeForReplace`
 
 The type of animation to use when this screen replaces another screen. It takes the following values:

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

@@ -166,6 +166,24 @@ See [Transparent modals](#transparent-modals) for more details on how to customi
 
 Whether transition animation should be enabled on the screen. If you set it to `false`, the screen won't animate when pushing or popping. Defaults to `true` on iOS and Android, `false` on Web.
 
+#### `animation`
+
+How the screen should animate when pushed or popped.
+
+Supported values:
+
+- `default`: use the platform default animation
+- `fade`: fade screen in or out
+- `fade_from_bottom`: fade the new screen from bottom
+- `slide_from_bottom`: slide in the new screen from bottom
+- `slide_from_right`: slide in the new screen from right
+- `slide_from_left`: slide in the new screen from left
+- `none`: don't animate the screen
+
+If `animation` is set, it overrides `cardStyleInterpolator` property.
+
+Only supported on Android and iOS.
+
 #### `animationTypeForReplace`
 
 The type of animation to use when this screen replaces another screen. It takes the following values: