Skip to content

Sync with react.dev @ f5fa1e82 - #755

Open
react-translations-bot wants to merge 60 commits into
mainfrom
sync-f5fa1e82
Open

react-translations-bot wants to merge 60 commits into
mainfrom
sync-f5fa1e82

Conversation

@react-translations-bot

Copy link
Copy Markdown
Collaborator

This PR was automatically generated.

Merge changes from react.dev at f5fa1e8

The following files have conflicts and may need new translations:

Please fix the conflicts by pushing new commits to this pull request, either by editing the files directly on GitHub or by checking out this branch.

DO NOT SQUASH MERGE THIS PULL REQUEST!

Doing so will "erase" the commits from main and cause them to show up as conflicts the next time we merge.

Simek and others added 30 commits August 24, 2026 10:33
* Add conditional browser query example

* Move browser query hook into its own example file

* Use IndexedDB in conditional browser example

* Clarify conditional browser rendering example

* Polish browser rendering examples

* Bridge conditional browser examples

* Tighten conditional browser example intro

* Use time zone for conditional browser example

* Clarify conditional example transition

* Lead conditional browser docs with time zone example

* Address conditional browser rendering feedback

* update

* Clarify conditional browser control flow

* Clarify conditional data fetching pattern

* Clarify conditional rendering outcomes

* Polish conditional browser examples

* Clarify conditional query rendering

* Align conditional browser guidance
…632)

* Document missing Fizz server rendering options and fix resume references

This adds the `formState`, `importMap`, `onHeaders`, and `maxHeadersLength` options to the `renderToPipeableStream` and `renderToReadableStream` reference pages, documents the object form of `nonce` for separate script and style nonces, and adds `importMap`, `onHeaders`, and `maxHeadersLength` to the `prerender` and `prerenderToNodeStream` pages. All of these options are supported in stable releases but were never documented. The `resumeAndPrerender` entries on the `react-dom/static` index were marked as experimental-only even though they ship in stable releases, so the badge is removed, and the `resumeAndPrerender` intro destructured a `postpone` property that is actually called `postponed`.

The `resumeToPipeableStream` page no longer documents a `signal` option because the Node.js implementation neither types nor reads it, and it now documents the `onAllReady` callback that the implementation does support. The same page referred to `resume` in its intro and Returns section where it meant `resumeToPipeableStream`, and the `react-dom/server` index linked both resume entries to the `renderToPipeableStream` page; they now point at their own pages.

Co-Authored-By: Claude Code (kimi-k3[1m]) <noreply@anthropic.com>

* Document the formState option for hydrateRoot

This adds the `formState` option to the `hydrateRoot` reference. The option carries the form state produced by a Server Function form submission so that `useActionState` with a `permalink` returns the submitted state during hydration instead of the initial state, and it must match the `formState` passed to the server renderer. The option shipped in React 19.0 but was never documented.

---------

Co-authored-by: Claude Code (kimi-k3[1m]) <noreply@anthropic.com>
* Validate inline code highlights in docs

* Match MDX code highlight metadata parsing
* Clarify standalone startTransition error handling

* Polish startTransition error handling docs

* Describe startTransition differences neutrally

* Clarify startTransition callback wording

* Remove repeated startTransition caveat

* Preserve existing startTransition guidance

* Preserve useTransition error guidance

* Update src/content/reference/react/useTransition.md

Co-authored-by: Sebastian "Sebbie" Silbermann <silbermann.sebastian@gmail.com>

* Clarify standalone startTransition error reporting

---------

Co-authored-by: Sebastian "Sebbie" Silbermann <silbermann.sebastian@gmail.com>
* Update browser.md

* Update browser.md
* Add React Advanced London 2026 and React Summit US 2026

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Retrigger CI

* Add React Day Berlin 2026, React Summit Asia 2027 and React Summit 2027

* Fix React Summit Asia 2027 dates

* Add LinkedIn links for React Summit and React Day Berlin

* Remove extra blank line between conference entries

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
* Document React-specific img behavior

* Explain empty image source caveat
…673)

Both became stable in React 19.3 and both have reference pages and
sidebar entries, but neither is listed on its overview page:

- `<ViewTransition>` is missing from Built-in React Components, which
  already lists its 19.3 sibling `<Activity>`.
- `addTransitionType` is missing from Built-in React APIs, which
  already lists `cache`, `cacheSignal` and `captureOwnerStack`.

CONTRIBUTING.md says the API Reference "is intended to be exhaustive",
so a reader browsing either overview page currently can't discover
either API.

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
* Clarify img View Transition example

* Avoid redundant image alt text

* Tighten img example introduction

* Move img example outcome below demo

* Clarify Suspense image example

* Simplify View Transition comparison examples

* Use a Suspense load in the image example

* Align Suspense resource loading examples

* Reduce View Transition example changes

* Remove artificial image loading delay

* Keep Suspense explanation self-contained

* Scope shared examples to each API

* Use Suspense for View Transition image example

* Make image loading comparison visible

* Tighten View Transition image examples

* Document View Transition resource timeout

* Cache image promises in Suspense examples

* Fix Suspense resource demos

* Clarify View Transition image reveal

* Fix Suspense font loading example

* Align image loading explanations

* Address image documentation review

* Simplify View Transition image guidance
…ule (#8501)

* docs: document fetchPriority support for preloadModule and preinitModule

* Update src/content/reference/react-dom/preinitModule.md

Co-authored-by: MaxwellCohen <to.email.max@gmail.com>

* Update src/content/reference/react-dom/preloadModule.md

Co-authored-by: MaxwellCohen <to.email.max@gmail.com>

---------

Co-authored-by: Aurora Scharff <66901228+aurorascharff@users.noreply.github.com>
Co-authored-by: MaxwellCohen <to.email.max@gmail.com>
…Effect reference (#8707)

* Fix broken React Router link in "Synchronizing with Effects"

* Fix broken React Router link in useEffect reference
… Conf Japan 2027 section (#8700)

* Update conferences: move concluded Sep 2026 events to Past, fix React Conf Japan 2027 section

* Update conferences: move concluded CityJS Athens 2026 to Past section

* Update conferences: move concluded React Advanced London 2026 to Past section
Twitter, Threads, and Bluesky links already included the member's
name in their aria-label, but GitHub and personal-site links used
generic labels ("GitHub Profile", "Personal Site") with no name —
inconsistent and confusing for screen reader users scanning the
team page. Standardize all five link types to include the member's
name, and mark their icons aria-hidden since the link's accessible
name already conveys the same information.

Fixes #8552

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Iitian001 <Iitian001@users.noreply.github.com>
…#8538)

* Fix Server Functions documentation examples

* Fix code snippet highlights

Corrected the index of 'submitAction' in the code snippet.

* Clarify wording

* Update section titles for clarity

* Polish Server Functions examples: consistent headings, reset wording, transition comment

- Convert the remaining two Usage headings to gerund form to match the
  rest of the page and react.dev convention (anchors unchanged)
- Reset wording: "succeeds" + "the form's uncontrolled fields" (aligns with #8512)
- Comment the startTransition-after-await; bump CodeStep line accordingly

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* Polish Server Functions examples

* Fix Server Functions code highlight

---------

Co-authored-by: Aurora Scharff <aurora.sofie@gmail.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
* Enhance form documentation for form default reset behavior

* Reorder sections for better progressive disclosure of ideas

* fix typos in form.md

* Normalize MDN links in form.md

* Standardized all Usage headings in form.md to imperative form

* add useOptimistic reference

* Standardize section headings in form.md to imperative form

* revert 'action' prop change

* Enhance form submission documentation by clarifying the use of the `action` prop and its behavior:
- including the handling of `FormData`,
- the necessity of `name` attributes,
- the advantages of using a function over a URL.
- removed redundant information about `e.preventDefault()` for the `action` prop.

* clean up Handling form submission with an action prop

* clean up preserving form values after submission

* update code example for Handling multiple submission types

* Clean up code example for Handling multiple submission types

* update form documentation with more examples of keeping form values after submission

* add useFormStatus to benefits of using Action

* Move reset form section to the bottom of the page and update examples

* updates based on pr feedback

* Enhance form documentation by clarifying the `action` and `method` props, including details on handling form submissions with functions and the implications of using `formAction`. Update examples and caveats for better understanding of form behavior in React.

* small cleanups

* Refine form Action documentation

* update Preserving form values after an Action section based on feedback

* update on onSubmit vs action prop note

* Enhance form documentation by expanding on the use of Server Functions in the `action` prop, including detailed examples for passing extra data and handling form submissions. Clarify the behavior of form elements and their interaction with `FormData`.

* fixing onSubmit link and code example clean up

* remove unneeded hidden items

* Polish form documentation wording

* Restore Transition link in form docs

* Clarify form value preservation examples and guidance

---------

Co-authored-by: Aurora Scharff <aurora.sofie@gmail.com>
… (#8653)

requestUsername is passed to useActionState but declared as
requestUsername(formData). useActionState calls the action with the
previous state as the first argument, so formData ends up null and
formData.get('username') throws. The useActionState reference already
covers this under "My Action cannot read form data".

Also drop a stray semicolon in the LikeButton example, where it sits in
the fragment's children and renders as text, and remove a duplicated
word in the RSC banner so it matches use-client.md.
…) (no AI or LLM used) (#8702)

Thanks to the React team for great documentation!

As a way to give back, I would like to share some simple typo fixes (any other type of content issues found will be fixed in separate commits):

- On https://react.dev/reference/react/useActionState (archived as is at https://web.archive.org/web/20261022181815/https://react.dev/reference/react/useActionState )
 "quanitiy" should be "quantity".

- On https://react.dev/reference/react/useContext (archived as is at https://web.archive.org/web/20261022181858/https://react.dev/reference/react/useContext )
 "mistakingly" should be removed (the sentence already ends in "by mistake", and "mistakenly" would seem to be the intended word if that had not been the case)

- On https://react.dev/reference/react/experimental_taintUniqueValue (archived as is at https://web.archive.org/web/20261022181913/https://react.dev/reference/react/experimental_taintUniqueValue )
 "untained" should be "untainted"

- On https://react.dev/reference/react-dom/flushSync (archived as is at https://web.archive.org/web/20261022184601/https://react.dev/reference/react-dom/flushSync )
 "syncronous" should be "synchronous"

- On https://react.dev/reference/react-dom/client/createRoot (archived as is at https://web.archive.org/web/20261022185916/https://react.dev/reference/react-dom/client/createRoot )
 "specfied" should be "specified"

- On https://react.dev/reference/react-dom/client/hydrateRoot (archived as is at https://web.archive.org/web/20261022190025/https://react.dev/reference/react-dom/client/hydrateRoot )
 "specfied" should be "specified"

- On https://react.dev/reference/react-dom/server/resume (archived as is at https://web.archive.org/web/20261022190141/https://react.dev/reference/react-dom/server/resume )
 "immediated" should be "immediately"

- https://react.dev/reference/dev-tools/react-performance-tracks (archived as is at https://web.archive.org/web/20261022190242/https://react.dev/reference/dev-tools/react-performance-tracks )
 "addititional" should be "additional"

- https://react.dev/reference/eslint-plugin-react-hooks/lints/use-memo (archived as is at https://web.archive.org/web/20261022190325/https://react.dev/reference/eslint-plugin-react-hooks/lints/use-memo )
 "sychronizes" should be "synchronizes"

- https://react.dev/versions (archived as is at https://web.archive.org/web/20261022190519/https://react.dev/versions )
 "Specificaion" should be "Specification"

- https://react.dev/reference/react/StrictMode (archived as is at https://web.archive.org/web/20261022190822/https://react.dev/reference/react/StrictMode )
 "inital" should be "initial"
* Update conference listings for 2026

* update typo for cityjs singapore 2026 website

* fix header typo for react india

* remove duplicates from past 2025 conference

* Update dates for React miami and react summit 2026

---------

Co-authored-by: Aurora Scharff <aurora.sofie@gmail.com>
see-stack and others added 27 commits November 4, 2026 19:03
* docs: explain useFormStatus with custom form actions

Closes #8682.

Document when `useFormStatus().pending` is set for a `preventDefault()` submit handler that starts a Transition in the same event, and add a runnable example for a custom form action. The example also notes that this pattern does not reset the form automatically.

Validation: `yarn check-all` and `git diff --check` pass locally. The initial draft was prepared with AI assistance and reviewed against the React DOM tests and issue details.

* Polish useFormStatus onSubmit documentation

* Clarify pending status and link form reset guidance

* Shorten pending definition and link onSubmit guidance

* Link form submission and Transition references

* Make form pending-state headings parallel

---------

Co-authored-by: Aurora Scharff <aurora.sofie@gmail.com>
Four links in Learn docs were missing the leading slash and would resolve to 404 paths. Every other internal link in the repo uses absolute paths.
Fixes #6933

The Server Components docs page had inconsistent handling of the note variable across 3 code examples. All examples now consistently treat note as an object with .authorId, .id, and .content properties.
Remove accidental repeated words in three reference pages:
- createRoot: 'can can' -> 'can'
- resumeAndPrerenderToNodeStream: 'a a' -> 'a'
- react-performance-tracks: 'the the' -> 'the'

Co-authored-by: eknathdj <eknathdj@users.noreply.github.com>
…#8483)

The ChatRoom.js sandpack in the "Fix a connection switch" challenge
imports useState but only uses useEffect. Remove the unused import
to avoid confusing learners.

Fixes #8231
Removed unused import of useState from React.
- 'an custom' -> 'a custom' in components/index.md (consonant sound)
- 'a object' -> 'an object' in taintUniqueValue.md (vowel sound)
…(#8667)

* Explain that the useState setter triggers a re-render in Quick Start

* Explain re-render behavior before naming it

---------

Co-authored-by: Dextheking1 <Dextheking1@users.noreply.github.com>
Co-authored-by: Aurora Scharff <aurora.sofie@gmail.com>
* Fix act() dispatch example using button before it is defined

The event example called button.dispatchEvent before const button was declared, which would throw at runtime. Also drop it.only from the docs snippet.

* Highlight the full act event-dispatch block

---------

Co-authored-by: Aurora Scharff <aurora.sofie@gmail.com>
…nsition (#8642)

* Remove redundant async in useTransition documentation

* Fix typo in useActionState hook documentation
* Clarify ref callback cleanup vs null behavior

* docs: incorporate review feedback on ref callback cleanup
Co-authored-by: sunmozong <sunmozong@kuaishou.com>
Co-authored-by: Ricky <rickhanlonii@gmail.com>
Fixes reactjs/react.dev#8375

The tutorial incorrectly used 'argument' when referring to the function
parameter  in the handleClick function declaration. In JavaScript:
- Parameter is the variable in the function declaration
- Argument is the actual value passed when calling the function

This change improves accuracy and helps learners understand the
distinction between these two important programming concepts.
* Update lifecycle-of-reactive-effects.md

* Remove useEffect from solution as well

---------

Co-authored-by: Jaem <91131509+DarkChocoJaem@users.noreply.github.com>
@vercel

vercel Bot commented Nov 9, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
tr-legacy-reactjs-org Error Error Nov 9, 2026 4:11am UTC

Request Review

This branch had an error being deployed

2 failed deployments
Preview – tr-legacy-reactjs-org — c204f29a Deployed Nov 9, 2026 by vercel[bot]
Preview – tr-react-dev — c204f29a Deployed Nov 9, 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.