feat: getLazy prop for bottom-navigation

example/src/Examples/BottomNavigationExample.tsx

@@ -162,6 +162,7 @@ const BottomNavigationExample = ({ navigation }: Props) => {
         sceneAnimationEnabled={sceneAnimation !== undefined}
         sceneAnimationType={sceneAnimation}
         sceneAnimationEasing={Easing.ease}
+        getLazy={({ route }) => route.key !== 'album'}
       />
     </View>
   );

src/components/BottomNavigation/BottomNavigation.tsx

@@ -38,6 +38,7 @@ type Route = {
   color?: string;
   accessibilityLabel?: string;
   testID?: string;
+  lazy?: boolean;
 };
 
 type NavigationState = {
@@ -262,6 +263,11 @@ export type Props = {
    * TestID used for testing purposes
    */
   testID?: string;
+  /**
+   * @supported Available in v5.x
+   * Get lazy for the current screen. Uses true by default.
+   */
+  getLazy?: (props: { route: Route }) => boolean | undefined;
 };
 
 const MIN_RIPPLE_SCALE = 0.001; // Minimum scale is not 0 due to bug with animation
@@ -385,6 +391,7 @@ const BottomNavigation = ({
   labelMaxFontSizeMultiplier = 1,
   compact = !theme.isV3,
   testID = 'bottom-navigation',
+  getLazy = ({ route }: { route: Route }) => route.lazy,
 }: Props) => {
   const { scale } = theme.animation;
 
@@ -679,7 +686,7 @@ const BottomNavigation = ({
     <View style={[styles.container, style]} testID={testID}>
       <View style={[styles.content, { backgroundColor: colors?.background }]}>
         {routes.map((route, index) => {
-          if (!loaded.includes(route.key)) {
+          if (getLazy({ route }) !== false && !loaded.includes(route.key)) {
             // Don't render a screen if we've never navigated to it
             return null;
           }

src/components/__tests__/BottomNavigation.test.js

@@ -370,3 +370,18 @@ it('renders a single tab', () => {
 
   expect(queryByTestId('bottom-navigation')).not.toBeNull();
 });
+
+it('renders bottom navigation with getLazy', () => {
+  const tree = render(
+    <BottomNavigation
+      navigationState={createState(0, 5)}
+      onIndexChange={jest.fn()}
+      renderScene={({ route }) => route.title}
+      getLazy={({ route }) => route.key === 'key-2'}
+    />
+  );
+
+  expect(tree).toMatchSnapshot();
+
+  expect(tree.queryByTestId('RouteScreen: 2')).toBeNull();
+});