mirror of
https://github.com/facebook/react-native.git
synced 2025-11-01 09:14:26 +00:00
Valentin Shergin
6a1438c044
Summary: `Element` is an abstraction layer that allows describing component hierarchy in a declarative way. Creating `Element`s themself does not create a component tree (aka `ShadowNode` tree) but describes some hierarchical structure that might be used to build an actual component tree (similar to XML Elements). `Element<>` provides some basic type-safety guarantees: all modifications of element objects require using objects (such as Props or State) of compatible type. For now, the only useful application of that is building tests. Changelog: [Internal] Fabric-specific internal change. Reviewed By: sammy-SC Differential Revision: D19512392 fbshipit-source-id: eb0711c2a537865fa5454dbede53412a135058cf
62 lines
1.4 KiB
C++
62 lines
1.4 KiB
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.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <functional>
|
|
#include <memory>
|
|
#include <vector>
|
|
|
|
#include <react/core/ShadowNode.h>
|
|
|
|
namespace facebook {
|
|
namespace react {
|
|
|
|
/*
|
|
* This is an implementation detail, do not use it directly.
|
|
* A type-erased version of `Element<>`.
|
|
* `ElementFragment` carries all information that is stored inside `Element<>`
|
|
* in some generalized, type-erased manner.
|
|
*/
|
|
class ElementFragment final {
|
|
public:
|
|
using Shared = std::shared_ptr<ElementFragment>;
|
|
using List = std::vector<ElementFragment>;
|
|
using ListOfShared = std::vector<Shared>;
|
|
using ReferenceCallback =
|
|
std::function<void(ShadowNode::Shared const &shadowNode)>;
|
|
using FinalizeCallback = std::function<void(ShadowNode &shadowNode)>;
|
|
|
|
/*
|
|
* ComponentDescriptor part (describes the type)
|
|
*/
|
|
ComponentHandle componentHandle;
|
|
ComponentName componentName;
|
|
|
|
/*
|
|
* ShadowNodeFamily part (describes the family)
|
|
*/
|
|
Tag tag;
|
|
SurfaceId surfaceId;
|
|
|
|
/*
|
|
* ShadowNode part (describes the instance)
|
|
*/
|
|
Props::Shared props;
|
|
State::Shared state;
|
|
List children;
|
|
|
|
/*
|
|
* Other
|
|
*/
|
|
ReferenceCallback referenceCallback;
|
|
FinalizeCallback finalizeCallback;
|
|
};
|
|
|
|
} // namespace react
|
|
} // namespace facebook
|