Files
react-native/ReactCommon/fabric/mounting/TreeStateReconciliation.h
T
Joshua Gross 27981ad991 Core: Add "state reconciliation" to commit phase, pre-layout
Summary:
This implements proposal #2 in our State architecture doc: https://fb.quip.com/bm2EAVwL7jQ5

Problem description: see the text in the comment of TreeStateReconciliation.h

Solution: see also comments in TreeStateReconciliation.h.

Changelog: [internal]

Reviewed By: mdvacca

Differential Revision: D19617329

fbshipit-source-id: 845fb5fe27f2591be433b6d77799707b3516fb1a
2020-02-08 11:33:43 -08:00

34 lines
1.3 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.
*/
#include <react/core/ShadowNode.h>
#include <react/core/ShadowNodeFragment.h>
namespace facebook {
namespace react {
/**
* Problem Description: because of C++ State, the React Native C++ ShadowTree
* can diverge from the ReactJS ShadowTree; ReactJS communicates all tree
* changes to C++, but C++ state commits are not propagated to ReactJS (ReactJS
* may or may not clone nodes with state changes, but it has no way of knowing
* if it /should/ clone those nodes; so those clones may never happen). This
* causes a number of problems. This function resolves the problem by taking a
* candidate tree being committed, and sees if any State changes need to be
* applied to it. If any changes need to be made, a new ShadowNode is returned;
* otherwise, nullptr is returned if the node is already consistent with the
* latest tree, including all state changes.
*
* This should be called during the commit phase, pre-layout and pre-diff.
*/
UnsharedShadowNode reconcileStateWithTree(
ShadowNode const *newNode,
SharedShadowNode committedNode);
} // namespace react
} // namespace facebook