Skip to content

Clarify that Fragment DOM and reconciliation behavior is runtime-defined #3241

Open

Description

@MuslumYilmaz

The Fragments section clearly shows the emitted code for the automatic and classic runtimes. It does not explicitly separate the compiler transform from runtime behavior, so readers may infer that Babel decides whether a Fragment creates DOM nodes or how Fragment identity is retained.

I suggest adding a short note after the Fragment examples that clarifies:

  • Babel rewrites fragment syntax to the configured Fragment reference or factory;
  • the transform itself does not create a DOM wrapper;
  • DOM shape, keyed identity, and component-state retention are defined by the selected JSX runtime and renderer, not by Babel;
  • the existing emitted-code examples remain unchanged.

An optional non-normative companion illustrating the React runtime consequences is Fragment DOM and reconciliation behavior.

Disclosure: I maintain FrontendAtlas. This would be documentation-only and would not imply a compiler behavior change. Would this scope be welcome as a small PR?

Activity

  1. babel-bot commented on Aug 26, 2026

    @babel-bot
    Contributor

    Hey @MuslumYilmaz! We really appreciate you taking the time to report an issue. The collaborators
    on this project attempt to help as many people as possible, but we're a limited number of volunteers,
    so it's possible this won't be addressed swiftly.

    If you need any help, or just have general Babel or JavaScript questions, we have a vibrant Slack
    community
    that typically always has someone willing to help. You can sign-up here
    for an invite.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions