mirror of
https://github.com/facebook/react-native.git
synced 2025-11-01 09:14:26 +00:00
Joshua Gross
34903ba418
Summary: See comments in ReactClippingProhibitedView for details and motivation behind this new feature. You may have a View class inherit from the ReactClippingProhibitedView interface in order to enable this feature for instances of that View type. This can be added to Views that should /never/ be clipped from the View hierarchy - namely, TTRC components or other telemetry components that always need to be rendered in order for some feature to function. Changelog: [Added] Opt-in mechanism to allow native Android Views to be marked as "not clippable", soft exceptions will be logged if these Views are clipped from the View hierarchy Reviewed By: sshic Differential Revision: D29472439 fbshipit-source-id: b3be53df836b452aed5dc40514ff585ce0ad812b
27 lines
1.2 KiB
Java
27 lines
1.2 KiB
Java
/*
|
|
* Copyright (c) Facebook, Inc. and its affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*/
|
|
|
|
package com.facebook.react.uimanager;
|
|
|
|
/**
|
|
* Some Views may not function if added directly to a ViewGroup that clips them. For example, TTRC
|
|
* markers may rely on `onDraw` functionality to work properly, and will break if they're clipped
|
|
* out of the View hierarchy for any resaon.
|
|
*
|
|
* <p>This situation can occur more often in Fabric with View Flattening. We may prevent this sort
|
|
* of View Flattening from occurring in the future, but the connection is not entirely certain.
|
|
*
|
|
* <p>This can occur either because ReactViewGroup clips them out, using the ordinarary subview
|
|
* clipping feature. It is also possible if a View is added directly to a ReactRootView below the
|
|
* fold of the screen.
|
|
*
|
|
* <p>Generally the solution is to prevent View flattening in JS by adding `collapsable=false` to a
|
|
* parent component of the clipped view, and/or move the View higher up in the hierarchy so it is
|
|
* always rendered within the first page of the screen.
|
|
*/
|
|
public interface ReactClippingProhibitedView {}
|