Skip to content

docs: clarify keyed Fragment reconciliation - #1394

Merged
rschristian merged 4 commits into
preactjs:masterfrom
MuslumYilmaz:docs-fragment-reconciliation-identity
Aug 26, 2026
Merged

rschristian merged 4 commits into
preactjs:masterfrom
MuslumYilmaz:docs-fragment-reconciliation-identity

Conversation

@MuslumYilmaz

@MuslumYilmaz MuslumYilmaz commented Aug 26, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Explain that a key identifies the whole Fragment during reconciliation.
  • Clarify why stable keys matter when Fragment groups are reordered.
  • Note that keyed Fragments require <Fragment key={...}>, since shorthand syntax cannot accept a key.
  • Keep the v10 and v11 English guides aligned.

The current example correctly recommends keys but stops at "Preact has to guess," leaving the group-identity and reordering consequence implicit.

Docs-only change; the same clarification is applied to the English v10 and v11 guides so their Fragment sections remain aligned.

@rschristian rschristian 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.

Content is otherwise good

Comment thread content/en/guide/v10/components.md Resolved

@rschristian rschristian 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.

Thanks!

@rschristian
rschristian merged commit 9f0190e into preactjs:master Aug 26, 2026
5 checks passed
1t1sCooL added a commit to 1t1sCooL/preact-www that referenced this pull request Aug 27, 2026
1t1sCooL added a commit to 1t1sCooL/preact-www that referenced this pull request Aug 27, 2026
rschristian added a commit that referenced this pull request Sep 7, 2026
…ion note) (#1395)

* docs: sync ru/guide/v10/components.md with #1394 (keyed Fragment note)

* docs: sync ru/guide/v11/components.md with #1394 (keyed Fragment note)

---------

Co-authored-by: Ryan Christian <[email protected]>
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.

2 participants