mirror of
https://github.com/facebook/react.git
synced 2025-11-01 09:12:30 +00:00
Jack Pope
6aa8254bb7
*This API is experimental and subject to change or removal.* This PR is an alternative to https://github.com/facebook/react/pull/32421 based on feedback: https://github.com/facebook/react/pull/32421#pullrequestreview-2625382015 . The difference here is that we traverse from the Fragment's fiber at operation time instead of keeping a set of children on the `FragmentInstance`. We still need to handle newly added or removed child nodes to apply event listeners and observers, so we treat those updates as effects. **Fragment Refs** This PR extends React's Fragment component to accept a `ref` prop. The Fragment's ref will attach to a custom host instance, which will provide an Element-like API for working with the Fragment's host parent and host children. Here I've implemented `addEventListener`, `removeEventListener`, and `focus` to get started but we'll be iterating on this by adding additional APIs in future PRs. This sets up the mechanism to attach refs and perform operations on children. The FragmentInstance is implemented in `react-dom` here but is planned for Fabric as well. The API works by targeting the first level of host children and proxying Element-like APIs to allow developers to manage groups of elements or elements that cannot be easily accessed such as from a third-party library or deep in a tree of Functional Component wrappers. ```javascript import {Fragment, useRef} from 'react'; const fragmentRef = useRef(null); <Fragment ref={fragmentRef}> <div id="A" /> <Wrapper> <div id="B"> <div id="C" /> </div> </Wrapper> <div id="D" /> </Fragment> ``` In this case, calling `fragmentRef.current.addEventListener()` would apply an event listener to `A`, `B`, and `D`. `C` is skipped because it is nested under the first level of Host Component. If another Host Component was appended as a sibling to `A`, `B`, or `D`, the event listener would be applied to that element as well and any other APIs would also affect the newly added child. This is an implementation of the basic feature as a starting point for feedback and further iteration.
99 lines
3.7 KiB
JavaScript
99 lines
3.7 KiB
JavaScript
/**
|
|
* 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.
|
|
*
|
|
* @flow
|
|
*/
|
|
|
|
import typeof * as FeatureFlagsType from 'shared/ReactFeatureFlags';
|
|
import typeof * as ExportsType from './ReactFeatureFlags.test-renderer';
|
|
|
|
export const enableAsyncDebugInfo = false;
|
|
export const enableSchedulingProfiler = false;
|
|
export const enableProfilerTimer = __PROFILE__;
|
|
export const enableProfilerCommitHooks = __PROFILE__;
|
|
export const enableProfilerNestedUpdatePhase = __PROFILE__;
|
|
export const enableComponentPerformanceTrack = false;
|
|
export const enableUpdaterTracking = false;
|
|
export const enableLegacyCache = __EXPERIMENTAL__;
|
|
export const enableAsyncIterableChildren = false;
|
|
export const enableTaint = true;
|
|
export const enablePostpone = false;
|
|
export const enableHalt = false;
|
|
export const disableCommentsAsDOMContainers = true;
|
|
export const disableInputAttributeSyncing = false;
|
|
export const enableScopeAPI = false;
|
|
export const enableCreateEventHandleAPI = false;
|
|
export const enableSuspenseCallback = false;
|
|
export const enableTrustedTypesIntegration = false;
|
|
export const disableTextareaChildren = false;
|
|
export const enableSuspenseAvoidThisFallback = false;
|
|
export const enableCPUSuspense = false;
|
|
export const enableNoCloningMemoCache = false;
|
|
export const enableUseEffectEventHook = false;
|
|
export const favorSafetyOverHydrationPerf = true;
|
|
export const enableLegacyFBSupport = false;
|
|
export const enableMoveBefore = false;
|
|
export const enableFabricCompleteRootInCommitPhase = false;
|
|
export const enableHiddenSubtreeInsertionEffectCleanup = false;
|
|
export const enableHydrationLaneScheduling = true;
|
|
|
|
export const enableRetryLaneExpiration = false;
|
|
export const retryLaneExpirationMs = 5000;
|
|
export const syncLaneExpirationMs = 250;
|
|
export const transitionLaneExpirationMs = 5000;
|
|
|
|
export const disableSchedulerTimeoutInWorkLoop = false;
|
|
export const enableLegacyHidden = false;
|
|
|
|
export const enableTransitionTracing = false;
|
|
|
|
export const enableDO_NOT_USE_disableStrictPassiveEffect = false;
|
|
export const enableFizzExternalRuntime = true;
|
|
|
|
export const alwaysThrottleRetries = true;
|
|
|
|
export const passChildrenWhenCloningPersistedNodes = false;
|
|
export const enablePersistedModeClonedFlag = false;
|
|
export const disableClientCache = true;
|
|
|
|
export const enableInfiniteRenderLoopDetection = false;
|
|
|
|
export const renameElementSymbol = true;
|
|
export const enableShallowPropDiffing = false;
|
|
export const enableSiblingPrerendering = true;
|
|
|
|
export const enableUseEffectCRUDOverload = false;
|
|
|
|
export const enableYieldingBeforePassive = true;
|
|
|
|
export const enableThrottledScheduling = false;
|
|
export const enableViewTransition = false;
|
|
export const enableSwipeTransition = false;
|
|
export const enableFastAddPropertiesInDiffing = true;
|
|
export const enableLazyPublicInstanceInFabric = false;
|
|
export const enableScrollEndPolyfill = true;
|
|
|
|
export const enableFragmentRefs = false;
|
|
|
|
// TODO: This must be in sync with the main ReactFeatureFlags file because
|
|
// the Test Renderer's value must be the same as the one used by the
|
|
// react package.
|
|
//
|
|
// We really need to get rid of this whole module. Any test renderer specific
|
|
// flags should be handled by the Fiber config.
|
|
// const __NEXT_MAJOR__ = __EXPERIMENTAL__;
|
|
export const disableLegacyMode = true;
|
|
export const disableLegacyContext = true;
|
|
export const disableLegacyContextForFunctionComponents = true;
|
|
export const enableRenderableContext = true;
|
|
export const enableReactTestRendererWarning = true;
|
|
export const disableDefaultPropsExceptForClasses = true;
|
|
|
|
export const enableObjectFiber = false;
|
|
|
|
// Flow magic to verify the exports of this file match the original version.
|
|
((((null: any): ExportsType): FeatureFlagsType): ExportsType);
|