Skip to content

Clarify image loading during View Transitions - #8671

Open
aurorascharff wants to merge 23 commits into
reactjs:mainfrom
aurorascharff:codex/clarify-img-start-transition
Open

aurorascharff wants to merge 23 commits into
reactjs:mainfrom
aurorascharff:codex/clarify-img-start-transition

Conversation

@aurorascharff

@aurorascharff aurorascharff commented Sep 23, 2026 •

Copy link
Copy Markdown
Collaborator

Follow-up to #8658.

Summary

  • clarify that React may wait for qualifying images during any client-rendered <ViewTransition> update
  • compare the same Suspense reveal inside and outside <ViewTransition> in both the <img> and Suspense references
  • use the Suspense retry to activate the image examples without an unrelated startTransition
  • keep the setup concise and describe the observable result after each example
  • remove redundant image alternative text from the profile examples

Validation

  • eslint src/content/reference/react-dom/components/img.md src/content/reference/react/Suspense.md
  • node scripts/headingIdLinter.js
  • git diff --check

@github-actions

github-actions Bot commented Sep 23, 2026 •

Copy link
Copy Markdown

Size changes

Details

📦 Next.js Bundle Analysis for react-dev

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

@aurorascharff aurorascharff changed the title Clarify the img View Transition example Clarify image loading during View Transitions Sep 23, 2026
@aurorascharff
aurorascharff marked this pull request as ready for review September 24, 2026 10:10
@aurorascharff
aurorascharff marked this pull request as draft September 24, 2026 10:11
@aurorascharff
aurorascharff marked this pull request as ready for review September 24, 2026 10:17
@aurorascharff
aurorascharff marked this pull request as draft September 24, 2026 10:18

@eps1lon eps1lon left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The image-waiting scope is incorrectly narrowed, and promised explanation and alternative-text cleanup remain incomplete.

Review effort: Balanced
Findings: 1 Medium severity · 4 Low severity

Open (5)
What changed in this PR

Clarifies how images and fonts load during React View Transitions.

Changes:

  • Compares Suspense reveals with and without <ViewTransition>.
  • Updates loading explanations and examples for React 19.3.
  • Revises profile and font demonstrations.
File Description
ViewTransition.md Clarifies Suspense reveal behavior.
Suspense.md Updates image, font, and coordinated-loading examples.
img.md Documents image waiting during View Transitions.

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread src/content/reference/react-dom/components/img.md Outdated
Comment thread src/content/reference/react-dom/components/img.md Outdated
Comment thread src/content/reference/react/Suspense.md
Comment thread src/content/reference/react/Suspense.md Outdated
Comment thread src/content/reference/react/Suspense.md Outdated

This branch was successfully deployed

1 active deployment
Preview — ea2e5354 Deployed Oct 4, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants