mirror of
https://github.com/facebook/react-native.git
synced 2025-11-01 09:14:26 +00:00
Summary: This diff introduces RCTComponentViewDescriptor - the container for a view and associated with this view properties which mounting infra uses for bookkeeping (and recycling) views. The previous implementation used raw Objective-C pointers to `UIView`s to store and manipulate them. The new way has a bunch of advantages: * It allows using high-performant C++ data collections for storing views and their properties (in future diffs). * The new approach allows us to avoid hacks around NSMapTable (such as ` [_registry setObject:componentView forKey:(__bridge id)(void *)tag];`) that were needed because NSMapTable wasn't designed for our use-case. * Dealing with `RCTComponentViewDescriptor` which stores a pointer to a view sometimes is actually more efficient than dealing with those pointers themselfs because we can deal with `const &` to a descriptor which does not require a ref-counter bump. * A new approach is much more flexible, it allows us to store additional data alongside view instances which we will use in coming diffs. Changelog: [Internal] Fabric-specific internal change. Reviewed By: sammy-SC Differential Revision: D18217102 fbshipit-source-id: 063e6c7df794a2e1fd690c194fb31ad6833eaba7
60 lines
2.0 KiB
Objective-C
60 lines
2.0 KiB
Objective-C
/*
|
|
* 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.
|
|
*/
|
|
|
|
#import <UIKit/UIKit.h>
|
|
|
|
#import <React/RCTComponentViewDescriptor.h>
|
|
#import <React/RCTComponentViewFactory.h>
|
|
#import <React/RCTComponentViewProtocol.h>
|
|
#import <react/core/ReactPrimitives.h>
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/**
|
|
* Registry of native component views.
|
|
* Provides basic functionality for allocation, recycling, and querying (by tag) native view instances.
|
|
*/
|
|
@interface RCTComponentViewRegistry : NSObject
|
|
|
|
@property (nonatomic, strong, readonly) RCTComponentViewFactory *componentViewFactory;
|
|
|
|
/**
|
|
* Returns a descriptor referring to a native view instance from the recycle pool (or being created on demand)
|
|
* for given `componentHandle` and with given `tag`.
|
|
* #RefuseSingleUse
|
|
*/
|
|
- (RCTComponentViewDescriptor)dequeueComponentViewWithComponentHandle:(facebook::react::ComponentHandle)componentHandle
|
|
tag:(facebook::react::Tag)tag;
|
|
|
|
/**
|
|
* Puts a given native component view to the recycle pool.
|
|
* #RefuseSingleUse
|
|
*/
|
|
- (void)enqueueComponentViewWithComponentHandle:(facebook::react::ComponentHandle)componentHandle
|
|
tag:(facebook::react::Tag)tag
|
|
componentViewDescriptor:(RCTComponentViewDescriptor)componentViewDescriptor;
|
|
|
|
/**
|
|
* Returns a component view descriptor by given `tag`.
|
|
*/
|
|
- (RCTComponentViewDescriptor const &)componentViewDescriptorWithTag:(facebook::react::Tag)tag;
|
|
|
|
/**
|
|
* Finds a native component view by given `tag`.
|
|
* Returns `nil` if there is no registered component with the `tag`.
|
|
*/
|
|
- (nullable UIView<RCTComponentViewProtocol> *)findComponentViewWithTag:(facebook::react::Tag)tag;
|
|
|
|
/**
|
|
* Creates a component view with a given type and puts it to the recycle pool.
|
|
*/
|
|
- (void)optimisticallyCreateComponentViewWithComponentHandle:(facebook::react::ComponentHandle)componentHandle;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|