mirror of
https://github.com/facebook/react-native.git
synced 2025-11-01 09:14:26 +00:00
Enrique López Mañas
73133a31d5
Summary: `SafeAreaView` has been marked for deprecation some time ago. The [following discussion](https://github.com/react-native-community/discussions-and-proposals/discussions/827) summarizes some of the arguments for it, but in a nutshell: it is iOS-only, limited in functionality, and incompatible with Android 15's enforced edge-to-edge rendering. ~~The Android/Kotlin classes have also been deprecated.~~ Not anymore, they are internal and might stay as they are. ## Changelog: [General] [Deprecated] - Deprecate SafeAreaView due to its iOS-only support and incompatibility with Android 15 edge-to-edge behavior; recommend using react-native-safe-area-context instead. <!-- Help reviewers and the release process by writing your own changelog entry. Pick one each for the category and type tags: [ANDROID|GENERAL|IOS|INTERNAL] [BREAKING|ADDED|CHANGED|DEPRECATED|REMOVED|FIXED|SECURITY] - Message For more details, see: https://reactnative.dev/contributing/changelogs-in-pull-requests Pull Request resolved: https://github.com/facebook/react-native/pull/51896 Test Plan: Access `SafeAreaView` in your code and check that the deprecation warning logs exactly once in the console. Reviewed By: rshest Differential Revision: D76816160 Pulled By: cortinico fbshipit-source-id: 60f539f9425f8ed8e19578a4530cb1f7d9b54488
34 lines
1.3 KiB
TypeScript
34 lines
1.3 KiB
TypeScript
/**
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*
|
|
* @format
|
|
*/
|
|
|
|
import type * as React from 'react';
|
|
import {Constructor} from '../../../types/private/Utilities';
|
|
import {NativeMethods} from '../../../types/public/ReactNativeTypes';
|
|
import {ViewProps} from '../View/ViewPropTypes';
|
|
|
|
/**
|
|
* @deprecated
|
|
* Use `react-native-safe-area-context` instead. This component is deprecated and will be removed in a future release.
|
|
*
|
|
* Renders nested content and automatically applies paddings reflect the portion of the view
|
|
* that is not covered by navigation bars, tab bars, toolbars, and other ancestor views.
|
|
* Moreover, and most importantly, Safe Area's paddings reflect physical limitation of the screen,
|
|
* such as rounded corners or camera notches (aka sensor housing area on iPhone X).
|
|
*/
|
|
declare class SafeAreaViewComponent extends React.Component<ViewProps> {}
|
|
|
|
declare const SafeAreaViewBase: Constructor<NativeMethods> &
|
|
typeof SafeAreaViewComponent;
|
|
|
|
/**
|
|
* @deprecated
|
|
* Use `react-native-safe-area-context` instead. This component is deprecated and will be removed in a future release.
|
|
*/
|
|
export class SafeAreaView extends SafeAreaViewBase {}
|