packages/react-native/ReactCommon/react/renderer/mounting/ShadowViewMutation.h - main - githubmr/facebook-react-native

packages/react-native/ReactCommon/react/renderer/mounting/ShadowViewMutation.h
138 строк4 KB
Pieter De Baets
Pass around parentTag instead of parentShadowView (#48062)
06 дек 2024, 14:31
06 дек 2024, 14:314134b1c
/*
 * 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.
 */

#pragma once

#include <vector>

#include <react/renderer/mounting/ShadowView.h>

namespace facebook::react {

/**
 * Describes a single native view tree mutation which may contain
 * pointers to an old shadow view, a new shadow view, a parent shadow view and
 * final index of inserted or updated view.
 * Use static methods to instantiate mutations of different types.
 */
struct ShadowViewMutation final {
  using List = std::vector<ShadowViewMutation>;

  ShadowViewMutation() = delete;

#pragma mark - Designated Initializers

  /**
   * Creates and returns an `Create` mutation.
   */
  static ShadowViewMutation CreateMutation(ShadowView shadowView);

  /**
   * Creates and returns an `Delete` mutation.
   */
  static ShadowViewMutation DeleteMutation(ShadowView shadowView);

  /**
   * Creates and returns an `Insert` mutation.
   */
  static ShadowViewMutation
  InsertMutation(Tag parentTag, ShadowView childShadowView, int index);

  /**
   * Creates and returns an `Insert` mutation.
   * @deprecated Pass parentTag instead of parentShadowView.
   */
  static ShadowViewMutation InsertMutation(
      const ShadowView& parentShadowView,
      ShadowView childShadowView,
      int index) {
    return InsertMutation(parentShadowView.tag, childShadowView, index);
  }

  /**
   * Creates and returns a `Remove` mutation.
   */
  static ShadowViewMutation
  RemoveMutation(Tag parentTag, ShadowView childShadowView, int index);

  /**
   * Creates and returns a `Remove` mutation.
   * @deprecated Pass parentTag instead of parentShadowView.
   */
  static ShadowViewMutation RemoveMutation(
      const ShadowView& parentShadowView,
      ShadowView childShadowView,
      int index) {
    return RemoveMutation(parentShadowView.tag, childShadowView, index);
  }

  /**
   * Creates and returns an `Update` mutation.
   */
  static ShadowViewMutation UpdateMutation(
      ShadowView oldChildShadowView,
      ShadowView newChildShadowView,
      Tag parentTag);

  /**
   * Creates and returns an `Update` mutation.
   * @deprecated Pass parentTag instead of parentShadowView.
   */
  static ShadowViewMutation UpdateMutation(
      ShadowView oldChildShadowView,
      ShadowView newChildShadowView,
      const ShadowView& parentShadowView) {
    return UpdateMutation(
        oldChildShadowView, newChildShadowView, parentShadowView.tag);
  }

#pragma mark - Type

  enum Type : std::uint8_t {
    Create = 1,
    Delete = 2,
    Insert = 4,
    Remove = 8,
    Update = 16,
  };

#pragma mark - Fields

  Type type = {Create};
  Tag parentTag = -1;
  ShadowView oldChildShadowView = {};
  ShadowView newChildShadowView = {};
  int index = -1;

  // Some platforms can have the notion of virtual views - views that are in the
  // ShadowTree hierarchy but never are on the platform. Generally this is used
  // so notify the platform that a view exists so that we can keep EventEmitters
  // around, to notify JS of something. This mechanism is DEPRECATED and it is
  // highly recommended that you NOT make use of this in your platform!
  bool mutatedViewIsVirtual() const;

 private:
  ShadowViewMutation(
      Type type,
      Tag parentTag,
      ShadowView oldChildShadowView,
      ShadowView newChildShadowView,
      int index);
};

using ShadowViewMutationList = std::vector<ShadowViewMutation>;

#if RN_DEBUG_STRING_CONVERTIBLE

std::string getDebugName(const ShadowViewMutation& mutation);
std::vector<DebugStringConvertibleObject> getDebugProps(
    const ShadowViewMutation& mutation,
    DebugStringConvertibleOptions options);

#endif

} // namespace facebook::react