unstale

npm / @floating-ui/react-dom

@floating-ui/react-dom

What changed in @floating-ui/react-dom 2, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-25.

5 breaking3 new APIs and options3 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.7 on npm

@floating-ui/react-dom 211 changes

Breaking changes 5

  • The deprecated top-level floating ref setter is removed; use refs.setFloating instead.

    2.0.0release notes

  • The deprecated top-level reference ref setter is removed; use refs.setReference instead.

    2.0.0release notes

  • The whileElementsMounted type now requires a cleanup function.

    2.0.0release notes

  • The default x coordinate is 0 instead of null; use isPositioned to determine whether the floating element has been positioned.

    2.0.0release notes

  • The default y coordinate is 0 instead of null; use isPositioned to determine whether the floating element has been positioned.

    2.0.0release notes

New APIs and options 3

  • useFloating accepts an optional floating element in elements for external element synchronization in the hook.

    2.0.0release notes

  • useFloating accepts an optional reference element in elements for external element synchronization in the hook.

    2.0.0release notes

  • useFloating returns a floatingStyles object with pre-configured positioning styles for the majority of cases.

    2.0.0release notes

Fixes and other changes 3

  • Optional properties now support explicit undefined when exactOptionalPropertyTypes is enabled.

    2.1.9release notes

  • Reactive middleware wrappers no longer produce a duplicate options key warning.

    2.1.8release notes

  • The arrow element option's type now allows null.

    2.0.0release notes