From 5c5e6cd8ce0bfb9c69ac39a1823872fc8eb8c40e Mon Sep 17 00:00:00 2001 From: Mathieu Acthernoene Date: Wed, 1 Jul 2026 15:10:33 -0700 Subject: [PATCH] Deprecate DrawerLayoutAndroid (#57397) Summary: Deprecates `DrawerLayoutAndroid` as part of the effort to keep core lean. It is Android only, and `react-native-drawer-layout` is a better, cross-platform alternative. This adds a `deprecated` JSDoc tag to the component and its props (Flow and TypeScript) and a one-time runtime warning when the component is imported, pointing users to `react-native-drawer-layout`. No behavior changes. ## Changelog: [ANDROID] [DEPRECATED] - Deprecate `DrawerLayoutAndroid`, use `react-native-drawer-layout` instead Pull Request resolved: https://github.com/react/react-native/pull/57397 Test Plan: - `deprecated` shows a strikethrough on `DrawerLayoutAndroid` in editors. - Importing/rendering `DrawerLayoutAndroid` logs the deprecation warning once, pointing to `react-native-drawer-layout`. Reviewed By: javache Differential Revision: D110334227 Pulled By: Abbondanzo fbshipit-source-id: 40edd2a4e997ba3ab350c7b7229beb237e83a57b --- .../DrawerAndroid/DrawerLayoutAndroid.android.js | 6 +++++- .../Components/DrawerAndroid/DrawerLayoutAndroid.d.ts | 11 ++++++++++- .../DrawerAndroid/DrawerLayoutAndroidTypes.js | 6 ++++++ packages/react-native/index.js | 11 +++++++++++ 4 files changed, 32 insertions(+), 2 deletions(-) diff --git a/packages/react-native/Libraries/Components/DrawerAndroid/DrawerLayoutAndroid.android.js b/packages/react-native/Libraries/Components/DrawerAndroid/DrawerLayoutAndroid.android.js index a2b98882a79..926fa7360f1 100644 --- a/packages/react-native/Libraries/Components/DrawerAndroid/DrawerLayoutAndroid.android.js +++ b/packages/react-native/Libraries/Components/DrawerAndroid/DrawerLayoutAndroid.android.js @@ -35,8 +35,12 @@ const DRAWER_STATES = ['Idle', 'Dragging', 'Settling'] as const; /** * React component that wraps the platform `DrawerLayout` (Android only). The Drawer (typically used for navigation) is rendered with `renderNavigationView` and direct children are the main view. The navigation view is initially not visible on the screen, but can be pulled in from the side of the window specified by the `drawerPosition` prop and its width can be set by the `drawerWidth` prop. * - * @see https://reactnative.dev/docs/drawerlayoutandroid + * DrawerLayoutAndroid is deprecated and will be removed in a future release. + * Use `react-native-drawer-layout` instead. + * + * @see https://reactnavigation.org/docs/drawer-layout/ * @platform android + * @deprecated */ class DrawerLayoutAndroid extends React.Component diff --git a/packages/react-native/Libraries/Components/DrawerAndroid/DrawerLayoutAndroid.d.ts b/packages/react-native/Libraries/Components/DrawerAndroid/DrawerLayoutAndroid.d.ts index 2f2e08efc1e..26fdec88e43 100644 --- a/packages/react-native/Libraries/Components/DrawerAndroid/DrawerLayoutAndroid.d.ts +++ b/packages/react-native/Libraries/Components/DrawerAndroid/DrawerLayoutAndroid.d.ts @@ -21,7 +21,10 @@ export interface DrawerSlideEvent extends NativeSyntheticEvent {} /** - * @see DrawerLayoutAndroid.android.js + * DrawerLayoutAndroid is deprecated and will be removed in a future release. + * Use `react-native-drawer-layout` instead. + * @see https://reactnavigation.org/docs/drawer-layout/ + * @deprecated */ export interface DrawerLayoutAndroidProps extends ViewProps { /** @@ -123,6 +126,12 @@ interface DrawerPosition { declare class DrawerLayoutAndroidComponent extends React.Component {} declare const DrawerLayoutAndroidBase: Constructor & typeof DrawerLayoutAndroidComponent; +/** + * DrawerLayoutAndroid is deprecated and will be removed in a future release. + * Use `react-native-drawer-layout` instead. + * @see https://reactnavigation.org/docs/drawer-layout/ + * @deprecated + */ export class DrawerLayoutAndroid extends DrawerLayoutAndroidBase { /** * drawer's positions. diff --git a/packages/react-native/Libraries/Components/DrawerAndroid/DrawerLayoutAndroidTypes.js b/packages/react-native/Libraries/Components/DrawerAndroid/DrawerLayoutAndroidTypes.js index d7f7df9c800..c5b16a13e09 100644 --- a/packages/react-native/Libraries/Components/DrawerAndroid/DrawerLayoutAndroidTypes.js +++ b/packages/react-native/Libraries/Components/DrawerAndroid/DrawerLayoutAndroidTypes.js @@ -27,6 +27,12 @@ export type DrawerSlideEvent = NativeSyntheticEvent< }>, >; +/** + * DrawerLayoutAndroid is deprecated and will be removed in a future release. + * Use `react-native-drawer-layout` instead. + * @see https://reactnavigation.org/docs/drawer-layout/ + * @deprecated + */ export type DrawerLayoutAndroidProps = Readonly<{ ...ViewProps, diff --git a/packages/react-native/index.js b/packages/react-native/index.js index 69c3f67ca8b..533c97f038f 100644 --- a/packages/react-native/index.js +++ b/packages/react-native/index.js @@ -38,7 +38,18 @@ module.exports = { get Button() { return require('./Libraries/Components/Button').default; }, + /** + * @deprecated DrawerLayoutAndroid is deprecated and will be removed in a future release. + * Use 'react-native-drawer-layout' instead. + * See https://reactnavigation.org/docs/drawer-layout/ + */ get DrawerLayoutAndroid() { + warnOnce( + 'drawer-layout-android-deprecated', + 'DrawerLayoutAndroid is deprecated and will be removed in a future release. ' + + "Use 'react-native-drawer-layout' instead. " + + 'See https://reactnavigation.org/docs/drawer-layout/', + ); return require('./Libraries/Components/DrawerAndroid/DrawerLayoutAndroid') .default; },