diff --git a/content/docs/reference-react.md b/content/docs/reference-react.md index 6d0101549fc..db1eea55d55 100644 --- a/content/docs/reference-react.md +++ b/content/docs/reference-react.md @@ -370,6 +370,14 @@ It is documented in our [code splitting guide](/docs/code-splitting.html#reactla > > For content that is already shown to the user, switching back to a loading indicator can be disorienting. It is sometimes better to show the "old" UI while the new UI is being prepared. To do this, you can use the new transition APIs [`startTransition`](#starttransition) and [`useTransition`](/docs/hooks-reference.html#usetransition) to mark updates as transitions and avoid unexpected fallbacks. +#### `React.Suspense` in Server Side Rendering +During server side rendering Suspense Boundaries allow you to flush your application in smaller chunks by suspending. +When a component suspends we schedule a low priority task to render the closest Suspense boundary's fallback. If the component unsuspends before we flush the fallback then we send down the actual content and throw away the fallback. + +#### `React.Suspense` during hydration +Suspense boundaries depend on their parent boundaries being hydrated before they can hydrate, but they can hydrate independently from sibling boundaries. Events on a boundary before its hydrated will cause the boundary to hydrate at +a higher priority than neighboring boundaries. [Read more](https://github.com/reactwg/react-18/discussions/130) + ### `React.startTransition` {#starttransition} ```js