mirror of
https://github.com/facebook/react.git
synced 2025-11-01 09:12:30 +00:00
efb22d8850
We've known we've wanted this for many years and most of the
implementation was already done for Suspensey CSS. This waits to commit
until images have decoded by default or up to 500ms timeout (same as
suspensey fonts).
It only applies to Transitions, Retries (Suspense), Gesture Transitions
(flag) and Idle (doesn't exist). Sync updates just commit immediately.
`<img loading="lazy" src="..." />` opts out since you explicitly want it
to load lazily in that case.
`<img onLoad={...} src="..." />` also opts out since that implies you're
ok with managing your own reveal.
In the future, we may add an opt in e.g. `<img blocking="render"
src="..." />` that opts into longer timeouts and re-suspends even sync
updates. Perhaps also triggering error boundaries on errors.
The rollout for this would have to go in a major and we may have to
relax the default timeout to not delay too much by default. However, we
can also make this part of `enableViewTransition` so that if you opt-in
by using View Transitions then those animations will suspend on images.
That we could ship in a minor.
632 lines
15 KiB
JavaScript
632 lines
15 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.
|
|
*/
|
|
|
|
import type {EventPriority} from 'react-reconciler/src/ReactEventPriorities';
|
|
|
|
import Transform from 'art/core/transform';
|
|
import Mode from 'art/modes/current';
|
|
|
|
import {TYPES, EVENT_TYPES, childrenAsString} from './ReactARTInternals';
|
|
|
|
import {
|
|
DefaultEventPriority,
|
|
NoEventPriority,
|
|
} from 'react-reconciler/src/ReactEventPriorities';
|
|
import type {ReactContext} from 'shared/ReactTypes';
|
|
import {REACT_CONTEXT_TYPE} from 'shared/ReactSymbols';
|
|
|
|
export {default as rendererVersion} from 'shared/ReactVersion';
|
|
export const rendererPackageName = 'react-art';
|
|
export const extraDevToolsConfig = null;
|
|
|
|
const pooledTransform = new Transform();
|
|
|
|
const NO_CONTEXT = {};
|
|
if (__DEV__) {
|
|
Object.freeze(NO_CONTEXT);
|
|
}
|
|
|
|
export type TransitionStatus = mixed;
|
|
|
|
/** Helper Methods */
|
|
|
|
function addEventListeners(instance, type, listener) {
|
|
// We need to explicitly unregister before unmount.
|
|
// For this reason we need to track subscriptions.
|
|
if (!instance._listeners) {
|
|
instance._listeners = {};
|
|
instance._subscriptions = {};
|
|
}
|
|
|
|
instance._listeners[type] = listener;
|
|
|
|
if (listener) {
|
|
if (!instance._subscriptions[type]) {
|
|
instance._subscriptions[type] = instance.subscribe(
|
|
type,
|
|
createEventHandler(instance),
|
|
instance,
|
|
);
|
|
}
|
|
} else {
|
|
if (instance._subscriptions[type]) {
|
|
instance._subscriptions[type]();
|
|
delete instance._subscriptions[type];
|
|
}
|
|
}
|
|
}
|
|
|
|
function createEventHandler(instance) {
|
|
return function handleEvent(event) {
|
|
const listener = instance._listeners[event.type];
|
|
|
|
if (!listener) {
|
|
// Noop
|
|
} else if (typeof listener === 'function') {
|
|
listener.call(instance, event);
|
|
} else if (listener.handleEvent) {
|
|
listener.handleEvent(event);
|
|
}
|
|
};
|
|
}
|
|
|
|
function destroyEventListeners(instance) {
|
|
if (instance._subscriptions) {
|
|
for (const type in instance._subscriptions) {
|
|
instance._subscriptions[type]();
|
|
}
|
|
}
|
|
|
|
instance._subscriptions = null;
|
|
instance._listeners = null;
|
|
}
|
|
|
|
function getScaleX(props) {
|
|
if (props.scaleX != null) {
|
|
return props.scaleX;
|
|
} else if (props.scale != null) {
|
|
return props.scale;
|
|
} else {
|
|
return 1;
|
|
}
|
|
}
|
|
|
|
function getScaleY(props) {
|
|
if (props.scaleY != null) {
|
|
return props.scaleY;
|
|
} else if (props.scale != null) {
|
|
return props.scale;
|
|
} else {
|
|
return 1;
|
|
}
|
|
}
|
|
|
|
function isSameFont(oldFont, newFont) {
|
|
if (oldFont === newFont) {
|
|
return true;
|
|
} else if (typeof newFont === 'string' || typeof oldFont === 'string') {
|
|
return false;
|
|
} else {
|
|
return (
|
|
newFont.fontSize === oldFont.fontSize &&
|
|
newFont.fontStyle === oldFont.fontStyle &&
|
|
newFont.fontVariant === oldFont.fontVariant &&
|
|
newFont.fontWeight === oldFont.fontWeight &&
|
|
newFont.fontFamily === oldFont.fontFamily
|
|
);
|
|
}
|
|
}
|
|
|
|
/** Render Methods */
|
|
|
|
function applyClippingRectangleProps(instance, props, prevProps = {}) {
|
|
applyNodeProps(instance, props, prevProps);
|
|
|
|
instance.width = props.width;
|
|
instance.height = props.height;
|
|
}
|
|
|
|
function applyGroupProps(instance, props, prevProps = {}) {
|
|
applyNodeProps(instance, props, prevProps);
|
|
|
|
instance.width = props.width;
|
|
instance.height = props.height;
|
|
}
|
|
|
|
function applyNodeProps(instance, props, prevProps = {}) {
|
|
const scaleX = getScaleX(props);
|
|
const scaleY = getScaleY(props);
|
|
|
|
pooledTransform
|
|
.transformTo(1, 0, 0, 1, 0, 0)
|
|
.move(props.x || 0, props.y || 0)
|
|
.rotate(props.rotation || 0, props.originX, props.originY)
|
|
.scale(scaleX, scaleY, props.originX, props.originY);
|
|
|
|
if (props.transform != null) {
|
|
pooledTransform.transform(props.transform);
|
|
}
|
|
|
|
if (
|
|
instance.xx !== pooledTransform.xx ||
|
|
instance.yx !== pooledTransform.yx ||
|
|
instance.xy !== pooledTransform.xy ||
|
|
instance.yy !== pooledTransform.yy ||
|
|
instance.x !== pooledTransform.x ||
|
|
instance.y !== pooledTransform.y
|
|
) {
|
|
instance.transformTo(pooledTransform);
|
|
}
|
|
|
|
if (props.cursor !== prevProps.cursor || props.title !== prevProps.title) {
|
|
instance.indicate(props.cursor, props.title);
|
|
}
|
|
|
|
if (instance.blend && props.opacity !== prevProps.opacity) {
|
|
instance.blend(props.opacity == null ? 1 : props.opacity);
|
|
}
|
|
|
|
if (props.visible !== prevProps.visible) {
|
|
if (props.visible == null || props.visible) {
|
|
instance.show();
|
|
} else {
|
|
instance.hide();
|
|
}
|
|
}
|
|
|
|
for (const type in EVENT_TYPES) {
|
|
addEventListeners(instance, EVENT_TYPES[type], props[type]);
|
|
}
|
|
}
|
|
|
|
function applyRenderableNodeProps(instance, props, prevProps = {}) {
|
|
applyNodeProps(instance, props, prevProps);
|
|
|
|
if (prevProps.fill !== props.fill) {
|
|
if (props.fill && props.fill.applyFill) {
|
|
props.fill.applyFill(instance);
|
|
} else {
|
|
instance.fill(props.fill);
|
|
}
|
|
}
|
|
if (
|
|
prevProps.stroke !== props.stroke ||
|
|
prevProps.strokeWidth !== props.strokeWidth ||
|
|
prevProps.strokeCap !== props.strokeCap ||
|
|
prevProps.strokeJoin !== props.strokeJoin ||
|
|
// TODO: Consider deep check of stokeDash; may benefit VML in IE.
|
|
prevProps.strokeDash !== props.strokeDash
|
|
) {
|
|
instance.stroke(
|
|
props.stroke,
|
|
props.strokeWidth,
|
|
props.strokeCap,
|
|
props.strokeJoin,
|
|
props.strokeDash,
|
|
);
|
|
}
|
|
}
|
|
|
|
function applyShapeProps(instance, props, prevProps = {}) {
|
|
applyRenderableNodeProps(instance, props, prevProps);
|
|
|
|
const path = props.d || childrenAsString(props.children);
|
|
|
|
const prevDelta = instance._prevDelta;
|
|
const prevPath = instance._prevPath;
|
|
|
|
if (
|
|
path !== prevPath ||
|
|
path.delta !== prevDelta ||
|
|
prevProps.height !== props.height ||
|
|
prevProps.width !== props.width
|
|
) {
|
|
instance.draw(path, props.width, props.height);
|
|
|
|
instance._prevDelta = path.delta;
|
|
instance._prevPath = path;
|
|
}
|
|
}
|
|
|
|
function applyTextProps(instance, props, prevProps = {}) {
|
|
applyRenderableNodeProps(instance, props, prevProps);
|
|
|
|
const string = props.children;
|
|
|
|
if (
|
|
instance._currentString !== string ||
|
|
!isSameFont(props.font, prevProps.font) ||
|
|
props.alignment !== prevProps.alignment ||
|
|
props.path !== prevProps.path
|
|
) {
|
|
instance.draw(string, props.font, props.alignment, props.path);
|
|
|
|
instance._currentString = string;
|
|
}
|
|
}
|
|
|
|
export * from 'react-reconciler/src/ReactFiberConfigWithNoPersistence';
|
|
export * from 'react-reconciler/src/ReactFiberConfigWithNoHydration';
|
|
export * from 'react-reconciler/src/ReactFiberConfigWithNoScopes';
|
|
export * from 'react-reconciler/src/ReactFiberConfigWithNoTestSelectors';
|
|
export * from 'react-reconciler/src/ReactFiberConfigWithNoMicrotasks';
|
|
export * from 'react-reconciler/src/ReactFiberConfigWithNoResources';
|
|
export * from 'react-reconciler/src/ReactFiberConfigWithNoSingletons';
|
|
|
|
export function appendInitialChild(parentInstance, child) {
|
|
if (typeof child === 'string') {
|
|
// Noop for string children of Text (eg <Text>{'foo'}{'bar'}</Text>)
|
|
throw new Error('Text children should already be flattened.');
|
|
}
|
|
|
|
child.inject(parentInstance);
|
|
}
|
|
|
|
export function createInstance(type, props, internalInstanceHandle) {
|
|
let instance;
|
|
|
|
switch (type) {
|
|
case TYPES.CLIPPING_RECTANGLE:
|
|
instance = Mode.ClippingRectangle();
|
|
instance._applyProps = applyClippingRectangleProps;
|
|
break;
|
|
case TYPES.GROUP:
|
|
instance = Mode.Group();
|
|
instance._applyProps = applyGroupProps;
|
|
break;
|
|
case TYPES.SHAPE:
|
|
instance = Mode.Shape();
|
|
instance._applyProps = applyShapeProps;
|
|
break;
|
|
case TYPES.TEXT:
|
|
instance = Mode.Text(
|
|
props.children,
|
|
props.font,
|
|
props.alignment,
|
|
props.path,
|
|
);
|
|
instance._applyProps = applyTextProps;
|
|
break;
|
|
}
|
|
|
|
if (!instance) {
|
|
throw new Error(`ReactART does not support the type "${type}"`);
|
|
}
|
|
|
|
instance._applyProps(instance, props);
|
|
|
|
return instance;
|
|
}
|
|
|
|
export function cloneMutableInstance(instance, keepChildren) {
|
|
return instance;
|
|
}
|
|
|
|
export function createTextInstance(
|
|
text,
|
|
rootContainerInstance,
|
|
internalInstanceHandle,
|
|
) {
|
|
return text;
|
|
}
|
|
|
|
export function cloneMutableTextInstance(textInstance) {
|
|
return textInstance;
|
|
}
|
|
|
|
export type FragmentInstanceType = null;
|
|
|
|
export function createFragmentInstance(fiber): null {
|
|
return null;
|
|
}
|
|
|
|
export function updateFragmentInstanceFiber(fiber, instance): void {
|
|
// Noop
|
|
}
|
|
|
|
export function commitNewChildToFragmentInstance(
|
|
child,
|
|
fragmentInstance,
|
|
): void {
|
|
// Noop
|
|
}
|
|
|
|
export function deleteChildFromFragmentInstance(child, fragmentInstance): void {
|
|
// Noop
|
|
}
|
|
|
|
export function finalizeInitialChildren(domElement, type, props) {
|
|
return false;
|
|
}
|
|
|
|
export function getPublicInstance(instance) {
|
|
return instance;
|
|
}
|
|
|
|
export function prepareForCommit() {
|
|
// Noop
|
|
return null;
|
|
}
|
|
|
|
export function resetAfterCommit() {
|
|
// Noop
|
|
}
|
|
|
|
export function resetTextContent(domElement) {
|
|
// Noop
|
|
}
|
|
|
|
export function getRootHostContext() {
|
|
return NO_CONTEXT;
|
|
}
|
|
|
|
export function getChildHostContext() {
|
|
return NO_CONTEXT;
|
|
}
|
|
|
|
export const scheduleTimeout = setTimeout;
|
|
export const cancelTimeout = clearTimeout;
|
|
export const noTimeout = -1;
|
|
|
|
export function shouldSetTextContent(type, props) {
|
|
return (
|
|
typeof props.children === 'string' || typeof props.children === 'number'
|
|
);
|
|
}
|
|
|
|
let currentUpdatePriority: EventPriority = NoEventPriority;
|
|
|
|
export function setCurrentUpdatePriority(newPriority: EventPriority): void {
|
|
currentUpdatePriority = newPriority;
|
|
}
|
|
|
|
export function getCurrentUpdatePriority(): EventPriority {
|
|
return currentUpdatePriority;
|
|
}
|
|
|
|
export function resolveUpdatePriority(): EventPriority {
|
|
return currentUpdatePriority || DefaultEventPriority;
|
|
}
|
|
|
|
export function trackSchedulerEvent(): void {}
|
|
|
|
export function resolveEventType(): null | string {
|
|
return null;
|
|
}
|
|
|
|
export function resolveEventTimeStamp(): number {
|
|
return -1.1;
|
|
}
|
|
|
|
export function shouldAttemptEagerTransition() {
|
|
return false;
|
|
}
|
|
|
|
// The ART renderer is secondary to the React DOM renderer.
|
|
export const isPrimaryRenderer = false;
|
|
|
|
// The ART renderer shouldn't trigger missing act() warnings
|
|
export const warnsIfNotActing = false;
|
|
|
|
export const supportsMutation = true;
|
|
|
|
export function appendChild(parentInstance, child) {
|
|
if (child.parentNode === parentInstance) {
|
|
child.eject();
|
|
}
|
|
child.inject(parentInstance);
|
|
}
|
|
|
|
export function appendChildToContainer(parentInstance, child) {
|
|
if (child.parentNode === parentInstance) {
|
|
child.eject();
|
|
}
|
|
child.inject(parentInstance);
|
|
}
|
|
|
|
export function insertBefore(parentInstance, child, beforeChild) {
|
|
if (child === beforeChild) {
|
|
throw new Error('ReactART: Can not insert node before itself');
|
|
}
|
|
|
|
child.injectBefore(beforeChild);
|
|
}
|
|
|
|
export function insertInContainerBefore(parentInstance, child, beforeChild) {
|
|
if (child === beforeChild) {
|
|
throw new Error('ReactART: Can not insert node before itself');
|
|
}
|
|
|
|
child.injectBefore(beforeChild);
|
|
}
|
|
|
|
export function removeChild(parentInstance, child) {
|
|
destroyEventListeners(child);
|
|
child.eject();
|
|
}
|
|
|
|
export function removeChildFromContainer(parentInstance, child) {
|
|
destroyEventListeners(child);
|
|
child.eject();
|
|
}
|
|
|
|
export function commitTextUpdate(textInstance, oldText, newText) {
|
|
// Noop
|
|
}
|
|
|
|
export function commitMount(instance, type, newProps) {
|
|
// Noop
|
|
}
|
|
|
|
export function commitUpdate(instance, type, oldProps, newProps) {
|
|
instance._applyProps(instance, newProps, oldProps);
|
|
}
|
|
|
|
export function hideInstance(instance) {
|
|
instance.hide();
|
|
}
|
|
|
|
export function hideTextInstance(textInstance) {
|
|
// Noop
|
|
}
|
|
|
|
export function unhideInstance(instance, props) {
|
|
if (props.visible == null || props.visible) {
|
|
instance.show();
|
|
}
|
|
}
|
|
|
|
export function unhideTextInstance(textInstance, text): void {
|
|
// Noop
|
|
}
|
|
|
|
export function applyViewTransitionName(instance, name, className) {
|
|
// Noop
|
|
}
|
|
|
|
export function restoreViewTransitionName(instance, props) {
|
|
// Noop
|
|
}
|
|
|
|
export function cancelViewTransitionName(instance, name, props) {
|
|
// Noop
|
|
}
|
|
|
|
export function cancelRootViewTransitionName(rootContainer) {
|
|
// Noop
|
|
}
|
|
|
|
export function restoreRootViewTransitionName(rootContainer) {
|
|
// Noop
|
|
}
|
|
|
|
export function cloneRootViewTransitionContainer(rootContainer) {
|
|
throw new Error('Not implemented.');
|
|
}
|
|
|
|
export function removeRootViewTransitionClone(rootContainer, clone) {
|
|
throw new Error('Not implemented.');
|
|
}
|
|
|
|
export type InstanceMeasurement = null;
|
|
|
|
export function measureInstance(instance) {
|
|
return null;
|
|
}
|
|
|
|
export function measureClonedInstance(instance) {
|
|
return null;
|
|
}
|
|
|
|
export function wasInstanceInViewport(measurement): boolean {
|
|
return true;
|
|
}
|
|
|
|
export function hasInstanceChanged(oldMeasurement, newMeasurement): boolean {
|
|
return false;
|
|
}
|
|
|
|
export function hasInstanceAffectedParent(
|
|
oldMeasurement,
|
|
newMeasurement,
|
|
): boolean {
|
|
return false;
|
|
}
|
|
|
|
export function startViewTransition() {
|
|
return null;
|
|
}
|
|
|
|
export type RunningViewTransition = null;
|
|
|
|
export function startGestureTransition() {
|
|
return null;
|
|
}
|
|
|
|
export function stopViewTransition(transition: RunningViewTransition) {}
|
|
|
|
export type ViewTransitionInstance = null | {name: string, ...};
|
|
|
|
export function createViewTransitionInstance(
|
|
name: string,
|
|
): ViewTransitionInstance {
|
|
return null;
|
|
}
|
|
|
|
export type GestureTimeline = null;
|
|
|
|
export function getCurrentGestureOffset(provider: GestureTimeline): number {
|
|
throw new Error('startGestureTransition is not yet supported in react-art.');
|
|
}
|
|
|
|
export function clearContainer(container) {
|
|
// TODO Implement this
|
|
}
|
|
|
|
export function getInstanceFromNode(node): null {
|
|
return null;
|
|
}
|
|
|
|
export function beforeActiveInstanceBlur(internalInstanceHandle: Object) {
|
|
// noop
|
|
}
|
|
|
|
export function afterActiveInstanceBlur() {
|
|
// noop
|
|
}
|
|
|
|
export function preparePortalMount(portalInstance: any): void {
|
|
// noop
|
|
}
|
|
|
|
// eslint-disable-next-line no-undef
|
|
export function detachDeletedInstance(node: Instance): void {
|
|
// noop
|
|
}
|
|
|
|
export function requestPostPaintCallback(callback: (time: number) => void) {
|
|
// noop
|
|
}
|
|
|
|
export function maySuspendCommit(type, props) {
|
|
return false;
|
|
}
|
|
|
|
export function maySuspendCommitOnUpdate(type, oldProps, newProps) {
|
|
return false;
|
|
}
|
|
|
|
export function maySuspendCommitInSyncRender(type, props) {
|
|
return false;
|
|
}
|
|
|
|
export function preloadInstance(type, props) {
|
|
// Return true to indicate it's already loaded
|
|
return true;
|
|
}
|
|
|
|
export function startSuspendingCommit() {}
|
|
|
|
export function suspendInstance(instance, type, props) {}
|
|
|
|
export function suspendOnActiveViewTransition(container) {}
|
|
|
|
export function waitForCommitToBeReady() {
|
|
return null;
|
|
}
|
|
|
|
export const NotPendingTransition = null;
|
|
export const HostTransitionContext: ReactContext<TransitionStatus> = {
|
|
$$typeof: REACT_CONTEXT_TYPE,
|
|
Provider: (null: any),
|
|
Consumer: (null: any),
|
|
_currentValue: NotPendingTransition,
|
|
_currentValue2: NotPendingTransition,
|
|
_threadCount: 0,
|
|
};
|
|
export function resetFormInstance() {}
|