Fluent UI Web

Fluent UI React is shipping its v9 final stable release. Visit the Fluent UI React v9 Release page on the wiki to learn more about the upcoming release schedule.

Fluent UI web represents a collection of utilities, React components, and Web Components for building web applications.

This repo is home to 3 separate projects today. Combining Fluent UI React v9 components with Fluent UI React v8 or v0 components is possible and allows gradual migration to Fluent UI v9.

The following table will help you navigate the 3 projects and understand their differences.

| | React Components (v9) | React (v8) | Web Components | |---| ----- | --------------- | -------------- | | Overview | New, future-proof and forward looking | Mature | Web Component implementation of Fluent UI. | | Used By | Microsoft 365 | Office | Edge | | Read Me | README.md | README.md| README.md | | Changelog | CHANGELOG.md | CHANGELOG.md | CHANGELOG.md | | Repo | packages/react-components | ./packages/react | ./packages/web-components | | Quick Start | Quick Start | Quick Start | See README.md | | Docs | https://react.fluentui.dev/ | aka.ms/fluentui-react | aka.ms/fluentui-web-components | | NPM | @fluentui/react-components | @fluentui/react| @fluentui/web-components | | Version | | | | | Issues | | | |

Why are there two React versions? Fluent UI v8 is still widely used. We encourage you to migrate to Fluent UI v9. See the Migration overview.

FluentUI Insights

Fluent UI Insights is a series that describes the design and decisions behind the Fluent UI design system.

EP01: Positioning	EP02: Styling	EP03: Griffel

EP04: Foundational APIs	EP05: Theming	EP06: Accessible by default

Licenses

All files on the Fluent UI React GitHub repository are subject to the MIT license. Please read the License file at the root of the project.

Usage of the fonts and icons referenced in Fluent UI React is subject to the terms of the assets license agreement.

Changelog

You can view the complete list of additions, fixes, and changes in the CHANGELOG.md file for each package.

Looking for Office UI Fabric React?

The Office UI Fabric React project has evolved to Fluent UI.

The office-ui-fabric-react repo is now this repo (fluentui in the Microsoft organization)! The name change should not disrupt any current Fabric usage, repo clones, pull requests, or issue reporting. Links should redirect to the new location. The library formerly known as office-ui-fabric-react is now available as @fluentui/react (see above table for more information).

We have a lot in store for Fluent UI - Read our announcement here.

Looking for Fluent UI React Northstar?

Fluent UI React Northstar has been superseded by Fluent UI React Components v9. For more details about Fluent UI React Northstar, see its README.md.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Change Log - @fluentui/react-utilities

This log was last generated on Wed, 16 Apr 2025 19:37:15 GMT and should not be manually modified.

9.19.0

Wed, 16 Apr 2025 19:37:15 GMT Compare changes

Minor changes

• Add getSlotClassNameProp_unstable function to allow custom style hooks to preserve the original className while overriding the component default className. (PR #34166 by behowell@microsoft.com)

9.18.23

Thu, 27 Mar 2025 21:12:51 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.23.1 (PR #34034 by beachball)

9.18.22

Wed, 19 Mar 2025 15:40:43 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.23.0 (PR #34032 by beachball)

9.18.21

Tue, 11 Mar 2025 18:58:54 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.22.0 (PR #33927 by beachball)

9.18.20

Wed, 22 Jan 2025 14:00:12 GMT Compare changes

Patches

• fix: add autoCorrect and minLength input properties support to getNativeProps utility (PR #33642 by dmytrokirpa@microsoft.com)

9.18.19

Mon, 16 Dec 2024 16:26:49 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.21.2 (PR #33468 by beachball)

9.18.18

Fri, 06 Dec 2024 12:53:45 GMT Compare changes

Patches

• chore: remove usage of "export *" (PR #33380 by olfedias@microsoft.com)
• Bump @fluentui/react-shared-contexts to v9.21.1 (PR #33372 by beachball)

9.18.17

Mon, 11 Nov 2024 10:00:38 GMT Compare changes

Patches

• chore: replace npm-scripts and just-scrtips with nx inferred tasks (PR #33074 by martinhochel@microsoft.com)
• Bump @fluentui/keyboard-keys to v9.0.8 (PR #33238 by beachball)
• Bump @fluentui/react-shared-contexts to v9.21.0 (PR #33238 by beachball)

9.18.16

Tue, 15 Oct 2024 17:17:51 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.20.2 (PR #32999 by beachball)

9.18.15

Mon, 23 Sep 2024 12:40:16 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.20.1 (PR #32840 by beachball)

9.18.14

Tue, 10 Sep 2024 10:19:11 GMT Compare changes

Patches

• chore: follow up on assertSlots fixes (PR #32323 by bernardo.sunderhus@gmail.com)

9.18.13

Tue, 23 Jul 2024 20:13:13 GMT Compare changes

Patches

• chore: stops leaking HTMLElementConstructorName type (PR #32072 by bernardo.sunderhus@gmail.com)
• chore: simplify SlotComponentType type (PR #31984 by olfedias@microsoft.com)
• Bump @fluentui/react-shared-contexts to v9.20.0 (PR #32067 by beachball)

9.18.12

Mon, 15 Jul 2024 17:25:23 GMT Compare changes

Patches

• chore: fix With* internal helper types 'children' verification (PR #31699 by bernardo.sunderhus@gmail.com)
• fix: revert incorectly set npm versions in all packages (PR #31937 by martinhochel@microsoft.com)
• bugfix: fix useMergedRefs signature to include null (PR #31951 by bernardo.sunderhus@gmail.com)
• Bump @fluentui/react-shared-contexts to v9.19.1 (PR #31998 by beachball)

9.18.11

Mon, 01 Jul 2024 20:30:39 GMT Compare changes

Patches

• chore: add eslint react-compiler (PR #31457 by seanmonahan@microsoft.com)

9.18.10

Thu, 06 Jun 2024 15:26:43 GMT Compare changes

Patches

• chore: useControllableState warns if controlled and uncontrolled at the same time (PR #31461 by bernardo.sunderhus@gmail.com)
• fix: use globals from Fluent context. (PR #30967 by seanmonahan@microsoft.com)

9.18.9

Mon, 20 May 2024 12:45:09 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.19.0 (PR #26682 by beachball)

9.18.8

Mon, 06 May 2024 12:55:02 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.18.0 (PR #31271 by beachball)

9.18.7

Tue, 23 Apr 2024 08:17:49 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.17.0 (PR #31113 by beachball)

9.18.6

Tue, 02 Apr 2024 09:48:01 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.16.0 (PR #30644 by beachball)

9.18.5

Mon, 18 Mar 2024 19:50:46 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.15.2 (PR #30600 by beachball)

9.18.4

Fri, 15 Mar 2024 21:43:49 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.15.1 (PR #30740 by beachball)

9.18.3

Thu, 07 Mar 2024 19:33:27 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.15.0 (PR #30687 by beachball)

9.18.2

Wed, 28 Feb 2024 02:34:19 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.14.1 (PR #30639 by beachball)

9.18.1

Tue, 20 Feb 2024 14:22:29 GMT Compare changes

Patches

• fix: Remove import cycle between assertSlots.ts and index.ts (PR #30555 by behowell@microsoft.com)

9.18.0

Tue, 30 Jan 2024 23:16:54 GMT Compare changes

Minor changes

• getParent() version with ShadowDOM support. (PR #30429 by marata@microsoft.com)

9.17.0

Tue, 23 Jan 2024 15:11:00 GMT Compare changes

Minor changes

• feat: helper type DistributiveOmit (PR #30317 by bernardo.sunderhus@gmail.com)

9.16.1

Thu, 18 Jan 2024 14:25:03 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.14.0 (PR #30046 by beachball)

9.16.0

Wed, 17 Jan 2024 16:18:50 GMT Compare changes

Minor changes

• Add new type EventHandler/EventData for callback props (PR #30322 by yuanboxue@microsoft.com)

9.15.6

Mon, 08 Jan 2024 16:24:28 GMT Compare changes

Patches

• Allow isSlot to work with multiple react-utilities instances (PR #30209 by 36034483+daniel-hauser@users.noreply.github.com)

9.15.5

Wed, 03 Jan 2024 09:26:43 GMT Compare changes

Patches

• chore: deprecate old slot API methods and types (PR #29646 by bernardo.sunderhus@gmail.com)

9.15.4

Mon, 18 Dec 2023 14:40:46 GMT Compare changes

Patches

• Bump @fluentui/react-shared-contexts to v9.13.2 (PR #30103 by beachball)

9.15.3

Thu, 14 Dec 2023 09:58:46 GMT Compare changes

Patches

• chore: disallow window and document access (PR #29962 by seanmonahan@microsoft.com)
• Bump @fluentui/react-shared-contexts to v9.13.1 (PR #30056 by beachball)

9.15.2

Thu, 09 Nov 2023 17:29:48 GMT Compare changes

Patches

• chore: use package.json#files setup instead of npmignore for all v9 libraries (PR #29734 by martinhochel@microsoft.com)
• Bump @fluentui/keyboard-keys to v9.0.7 (PR #29800 by beachball)

9.15.1

Wed, 18 Oct 2023 17:54:07 GMT Compare changes

Patches

• chore: deprecate getNativeElementProps in favor of getIntrinsicElementProps (PR #29535 by bernardo.sunderhus@gmail.com)

9.15.0

Wed, 11 Oct 2023 13:54:26 GMT Compare changes

Minor changes

• feat: Add virtual parent utilties (PR #29286 by lingfan.gao@microsoft.com)

9.14.2

Mon, 09 Oct 2023 20:45:44 GMT Compare changes

Patches

• chore: add e2e test for useOnScrollOutside (PR #29413 by yuanboxue@microsoft.com)

9.14.1

Thu, 05 Oct 2023 15:25:34 GMT Compare changes

Patches

• Revert fix: useOnScrollOutside should invoke callback on dragging scrollbar (PR #29412 by yuanboxue@microsoft.com)

9.14.0

Wed, 04 Oct 2023 08:45:47 GMT Compare changes

Minor changes

• feat: creates getIntrinsicElementProps to replace getNativeElementProps on slots creation (PR #29310 by bernardo.sunderhus@gmail.com)

9.13.5

Tue, 26 Sep 2023 17:49:15 GMT Compare changes

Patches

• chore: trigger manual version bump after broken release (PR #29303 by yuanboxue@microsoft.com)
• Bump @fluentui/keyboard-keys to v9.0.6 (PR #29303 by beachball)

9.13.4

Tue, 26 Sep 2023 15:31:40 GMT Compare changes

Patches

• fix: bump swc core to mitigate transpilation memory leaks (PR #29253 by martinhochel@microsoft.com)
• Bump @fluentui/keyboard-keys to v9.0.5 (PR #29300 by beachball)

9.13.3

Wed, 06 Sep 2023 13:31:31 GMT Compare changes

Patches

• Revert fix: useOnClickOutside should invoke callback on clicking scrollbar (PR #29065 by yuanboxue@microsoft.com)

9.13.2

Tue, 05 Sep 2023 15:39:03 GMT Compare changes

Patches

• fix: useOnScrollOutside should invoke callback on dragging scrollbar (PR #29062 by yuanboxue@microsoft.com)

9.13.1

Tue, 05 Sep 2023 13:29:11 GMT Compare changes

Patches

• bumps @swc/helpers version to 0.5.1 (PR #28989 by bernardo.sunderhus@gmail.com)
• chore: adds swc-plugin-de-indent-template-literal to remove indentation of consoles (PR #29040 by bernardo.sunderhus@gmail.com)
• fix: use timeout instead of requestAnimationFrame for ssr (PR #29015 by marcosvmmoura@gmail.com)
• bumps react peer dependencies to v16.14.0 (PR #28959 by bernardo.sunderhus@gmail.com)
• Bump @fluentui/keyboard-keys to v9.0.4 (PR #29056 by beachball)

9.13.0

Tue, 29 Aug 2023 12:57:36 GMT Compare changes

Minor changes

• feat: add disabledFocusOnIframe for useOnClickOutside() (PR #28881 by olfedias@microsoft.com)

Patches

• fix: useOnClickOutside should invoke callback on clicking scrollbar (PR #28965 by yuanboxue@microsoft.com)

9.12.0

Thu, 24 Aug 2023 10:26:34 GMT Compare changes

Minor changes

• feat: create a new useAnimationFrame hook (PR #28948 by marcosvmmoura@gmail.com)

Patches

• fix: useOnClickOutside should consider text selection starting inside and finishing outside as an inside click (PR #28765 by yuanboxue@microsoft.com)

9.11.2

Wed, 23 Aug 2023 12:01:49 GMT Compare changes

Patches

• bugfix: ensure interop between assertSlots and old API (PR #28957 by bernardo.sunderhus@gmail.com)

9.11.1

Fri, 11 Aug 2023 12:14:25 GMT Compare changes

Patches

• chore: tests for slot.resolveShorthand behavior (PR #28819 by bernardo.sunderhus@gmail.com)

9.11.0

Fri, 04 Aug 2023 08:52:58 GMT Compare changes

Minor changes

• feat: implement new slot methods (slot and assertSlots) (PR #28373 by bernardo.sunderhus@gmail.com)

9.10.1

Mon, 03 Jul 2023 11:57:14 GMT Compare changes

Patches

• bugfix: removes default prevention verification on selection (PR #28365 by bernardo.sunderhus@gmail.com)
• chore: adds internal tag on jsdoc for getSlotsNext (PR #28348 by bernardo.sunderhus@gmail.com)

9.10.0

Wed, 28 Jun 2023 11:12:35 GMT Compare changes

Minor changes

• feat: creates useSelection hook (PR #28335 by bernardo.sunderhus@gmail.com)

9.9.4

Mon, 26 Jun 2023 09:53:54 GMT Compare changes

Patches

• fix: add compatibility with shadow (PR #28307 by olfedias@microsoft.com)

9.9.3

Tue, 20 Jun 2023 12:39:06 GMT Compare changes

Patches

• fix: getNativeElementProps should support animation event handlers (PR #28094 by lingfangao@hotmail.com)

9.9.2

Wed, 31 May 2023 06:46:22 GMT Compare changes

Patches

• fix: tweak type errors exposed in ts 4.5 (PR #27936 by martinhochel@microsoft.com)

9.9.1

Thu, 25 May 2023 10:00:48 GMT Compare changes

Patches

• fix(react-utilities): fix dispatcher behavior (PR #27978 by olfedias@microsoft.com)

9.9.0

Thu, 18 May 2023 00:39:19 GMT Compare changes

Minor changes

• feat: Implement a priority queue (PR #27848 by lingfangao@hotmail.com)

9.8.1

Fri, 12 May 2023 20:28:04 GMT Compare changes

Patches

• feat: defers useControllableState state to initializer method (PR #27717 by bernardo.sunderhus@gmail.com)
• chore: updates useControllableState comments (PR #27754 by bernardo.sunderhus@gmail.com)
• chore: exclude .swcrc from being published (PR #27740 by olfedias@microsoft.com)
• chore: simplifies useControllableState hook internals (PR #27702 by bernardo.sunderhus@gmail.com)
• Bump @fluentui/keyboard-keys to v9.0.3 (PR #27827 by beachball)

9.8.0

Mon, 17 Apr 2023 17:54:02 GMT Compare changes

Minor changes

• feat: ensure compatibility with custom JSX pragma (PR #27472 by bernardo.sunderhus@gmail.com)

Patches

• fix: Fix slot render functions (PR #27561 by behowell@microsoft.com)

9.7.4

Wed, 12 Apr 2023 09:31:45 GMT Compare changes

Patches

• fix(hooks): cleanup event listeners only when "disabled" is false (PR #27516 by olfedias@microsoft.com)

9.7.3

Tue, 04 Apr 2023 18:44:50 GMT Compare changes

Patches

• bugfix: increments SlotRenderFunction signature to include children (PR #27377 by bernardo.sunderhus@gmail.com)

9.7.2

Tue, 21 Mar 2023 21:23:15 GMT Compare changes

Patches

• chore: exports isHTMLElement as public (PR #27178 by bernardo.sunderhus@gmail.com)
• fix: add node field to package.json exports map. (PR #27154 by tristan.watanabe@gmail.com)
• chore: migrate to swc transpilation approach. (PR #27250 by tristan.watanabe@gmail.com)
• Bump @fluentui/keyboard-keys to v9.0.2 (PR #27271 by beachball)

9.7.1

Thu, 16 Mar 2023 14:36:58 GMT Compare changes

Patches

• fix(getSlots): stops slotProps.slot to be typed as never (PR #27231 by bernardo.sunderhus@gmail.com)

9.7.0

Mon, 13 Mar 2023 08:58:26 GMT Compare changes

Minor changes

• feat: isHTMLElement to support all HTMLElement classes (PR #27161 by bernardo.sunderhus@gmail.com)

9.6.2

Fri, 10 Mar 2023 07:14:01 GMT Compare changes

Patches

• fix: ResolveShorthandOptions type to better reflect implementation (PR #27112 by bernardo.sunderhus@gmail.com)

9.6.1

Wed, 08 Mar 2023 17:42:49 GMT Compare changes

Patches

• fix: adjust IntrinsicElementProps type to properly support void elements (PR #27095 by bernardo.sunderhus@gmail.com)
• fix: export omit function (PR #26958 by martinhochel@microsoft.com)

9.6.0

Wed, 15 Feb 2023 11:44:51 GMT Compare changes

Minor changes

• feat: Add event helpers to ease working with mouse and touch (PR #26784 by jirivyhnalek@microsoft.com)

Patches

• fix(useOnClickOutside): iframe focus detection uses contains (PR #26845 by lingfangao@hotmail.com)

9.5.3

Mon, 13 Feb 2023 23:43:13 GMT Compare changes

Patches

• fix: resolveShorthand should resolve an object as its copy (PR #26825 by yuanboxue@microsoft.com)

9.5.2

Fri, 10 Feb 2023 08:50:01 GMT Compare changes

Patches

• fix: Generate id first to avoid hook order mismatch in React 18 and remove colons from generated id in React 18. (PR #26745 by esteban.230@hotmail.com)

9.5.1

Tue, 31 Jan 2023 19:53:58 GMT Compare changes

Patches

• fix: update definitions for SSRProvider (PR #25582 by olfedias@microsoft.com)

9.5.0

Thu, 26 Jan 2023 13:31:03 GMT Compare changes

Minor changes

• feat: add IdPrefixProvider (PR #26496 by olfedias@microsoft.com)

Patches

• fix: Leverage React.useId when available for our useId hook. (PR #26465 by esteban.230@hotmail.com)

9.4.0

Mon, 09 Jan 2023 14:35:02 GMT Compare changes

Minor changes

• feat: implement useScrollbarWidth utility hook (PR #26144 by lingfangao@hotmail.com)

9.3.1

Wed, 04 Jan 2023 01:40:43 GMT Compare changes

Patches

• feat: generalize is HTMLElement attribute to unknown (PR #25991 by bernardo.sunderhus@gmail.com)

9.3.0

Tue, 20 Dec 2022 14:59:33 GMT Compare changes

Minor changes

• feat: isHTMLElement helper function (PR #25891 by bernardo.sunderhus@gmail.com)
• feat: replace shouldPreventKeydown with isInteractiveHTMLElement (PR #25942 by lingfangao@hotmail.com)

9.2.2

Thu, 17 Nov 2022 23:05:30 GMT Compare changes

Patches

• fix: supports colSpan property for th (PR #25613 by bernardo.sunderhus@gmail.com)

9.2.1

Fri, 11 Nov 2022 14:57:49 GMT Compare changes

Patches

• fix: create valid export maps (PR #25558 by martinhochel@microsoft.com)
• Bump @fluentui/keyboard-keys to v9.0.1 (PR #25615 by beachball)

9.2.0

Wed, 02 Nov 2022 11:58:06 GMT Compare changes

Minor changes

• feat: exposes internal methods that are used in the API surface (PR #25406 by bernardo.sunderhus@gmail.com)

9.1.2

Thu, 20 Oct 2022 08:39:56 GMT Compare changes

Patches

• chore: Bump react peer dependency to react 18. (PR #25278 by mgodbolt@microsoft.com)

9.1.1

Thu, 13 Oct 2022 11:03:05 GMT Compare changes

Patches

• chore: restricts trigger API types (PR #25044 by bernardo.sunderhus@gmail.com)

9.1.0

Thu, 15 Sep 2022 09:48:57 GMT Compare changes

Minor changes

• feat: add dialog properties to getNativeElementProps (PR #24698 by bernardo.sunderhus@gmail.com)
• fix: Replace deprecated ReactNodeArray for React 17 support. (PR #24356 by tristan.watanabe@gmail.com)
• feat(react-utilities): adds isResolvedShorthand guard method (PR #24535 by bernardo.sunderhus@gmail.com)

Patches

• chore: fix no-context-default-value lint violations (PR #24276 by lingfangao@hotmail.com)
• fix: add microdata properties to allowed html properties (PR #24652 by yuanboxue@microsoft.com)
• refactor: Replace useMergedEventCallbacks utility with mergeCallbacks (PR #24152 by behowell@microsoft.com)

9.0.2

Thu, 14 Jul 2022 21:21:07 GMT Compare changes

Patches

• fix: Fixing bad version bump of @fluentui/react-utilities. (PR #23920 by Humberto.Morimoto@microsoft.com)

9.0.1-0

Thu, 14 Jul 2022 17:06:25 GMT Compare changes

Changes

• chore: improve error message in useIsSSR() (PR #23750 by olfedias@microsoft.com)

9.0.0

Tue, 28 Jun 2022 15:13:25 GMT Compare changes

Patches

• feat: Initial 9.0.0 release (PR #23733 by lingfangao@hotmail.com)
• Bump @fluentui/keyboard-keys to v9.0.0 (commit by beachball)

Changes

• Update 9.0.0-rc dependencies to use caret range (PR #23732 by lingfangao@hotmail.com)
• fix: useOnClickOutside should trigger for webviews (PR #23535 by jukapsia@microsoft.com)
• feat: add void function component support to slots (PR #23408 by 39736248+andrefcdias@users.noreply.github.com)
• chore: Mark teams-prg owned APIs with @internal (PR #23689 by lingfangao@hotmail.com)
• chore: moves trigger methods to separate folder (PR #23574 by bernardo.sunderhus@gmail.com)

9.0.0-rc.10

Tue, 31 May 2022 21:28:50 GMT Compare changes

Changes

• remove exports for internals APIs & unused hooks (PR #23319 by olfedias@microsoft.com)

9.0.0-rc.9

Mon, 23 May 2022 12:13:58 GMT Compare changes

Changes

• feat: ship rolluped only dts (PR #22828 by martinhochel@microsoft.com)

9.0.0-rc.8

Thu, 05 May 2022 18:26:28 GMT Compare changes

Changes

• feat: add time element on nativeElementMap (PR #22848 by bsunderhus@microsoft.com)
• Bump @fluentui/keyboard-keys to v9.0.0-rc.6 (PR #22857 by beachball)

9.0.0-rc.7

Wed, 04 May 2022 13:26:36 GMT Compare changes

Changes

• Bump @fluentui/keyboard-keys to v9.0.0-rc.5 (PR #22786 by beachball)

9.0.0-rc.6

Tue, 19 Apr 2022 19:17:05 GMT Compare changes

Changes

• Removing star exports at src/index.ts (PR #22367 by Humberto.Morimoto@microsoft.com)

9.0.0-rc.5

Fri, 04 Mar 2022 05:17:32 GMT Compare changes

Changes

• Adding explicit export maps on all consumer packages for FUIR 8 and 9. (PR #21508 by dzearing@microsoft.com)
• Adding helper type to define slot class names. (PR #21933 by email not defined)
• fix(shouldPreventDefaultOnKeyDown): return false for events that are default prevented (PR #21905 by lingfangao@hotmail.com)
• Bump @fluentui/keyboard-keys to v9.0.0-rc.4 (PR #21947 by beachball)

9.0.0-rc.4

Tue, 01 Mar 2022 02:17:39 GMT Compare changes

Changes

• Ignore prefix in useId() when it is falsey. (PR #21848 by seanmonahan@microsoft.com)
• Add fieldset to getNativeElementProps (PR #21835 by behowell@microsoft.com)

9.0.0-rc.3

Fri, 18 Feb 2022 13:35:37 GMT Compare changes

Changes

• fix: Source maps contain original source code (PR #21690 by lingfangao@hotmail.com)
• Bump @fluentui/keyboard-keys to v9.0.0-rc.3 (PR #21800 by beachball)

9.0.0-rc.1

Thu, 10 Feb 2022 08:50:32 GMT Compare changes

Changes

• Rename component hooks add the suffix _unstable, as their API has not been finalized yet (PR #21365 by behowell@microsoft.com)
• getSlots: remove slotNames param, and infer from state.components instead (PR #21134 by behowell@microsoft.com)
• add useTriggerElement() hook (PR #21225 by olfedias@microsoft.com)
• Removes nullRender from react-utilities (PR #21576 by bsunderhus@microsoft.com)
• update applyTriggerPropsToChildren() to return React.ReactElement or null (PR #21609 by olfedias@microsoft.com)
• Refactor component Slot typings (PR #21518 by behowell@microsoft.com)
• Adding ComponentSlotProps to allow ref to be passed in composite components. (PR #20890 by Humberto.Morimoto@microsoft.com)
• Renaming most Shorthand composition types to SlotProps so they better reflect what the types do. (PR #20891 by Humberto.Morimoto@microsoft.com)
• Bump Fluent UI packages to 9.0.0-rc (PR #21623 by lingfangao@hotmail.com)
• Update trigger utilities to handle nested triggers (PR #21495 by behowell@microsoft.com)
• [breaking] Remove useControllableValue hook (use useControllableState instead) (PR #20865 by elcraig@microsoft.com)
• Bump @fluentui/keyboard-keys to v9.0.0-rc.1 (commit by beachball)

9.0.0-beta.4

Thu, 25 Nov 2021 08:34:09 GMT Compare changes

Changes

• Update utility types to support specifying a primary slot other than root (PR #20617 by behowell@microsoft.com)

9.0.0-beta.3

Fri, 12 Nov 2021 13:25:10 GMT Compare changes

Changes

• Updated beta and RC components to ES2019 (PR #20405 by gcox@microsoft.com)

9.0.0-beta.2

Wed, 27 Oct 2021 12:14:24 GMT Compare changes

Changes

• remove compat utilities and types (PR #20255 by olfedias@microsoft.com)
• fix(getNativeElementPrps): Add support for onAuxClick (PR #20343 by lingfangao@hotmail.com)

9.0.0-beta.1

Wed, 06 Oct 2021 10:37:22 GMT Compare changes

Changes

• Bump all v9 components to beta prerelease tag (PR #20106 by lingfangao@hotmail.com)
• Bump @fluentui/keyboard-keys to v9.0.0-beta.1 (PR #20106 by beachball)

9.0.0-alpha.56

Tue, 05 Oct 2021 09:28:07 GMT Compare changes

Changes

• Add and use ForwardRefComponent helper type (PR #20081 by elcraig@microsoft.com)

9.0.0-alpha.55

Fri, 01 Oct 2021 14:13:08 GMT Compare changes

Changes

• Bump v9 prerelease versions to rerelease (PR #20069 by lingfangao@hotmail.com)
• Bump @fluentui/keyboard-keys to v9.0.0-alpha.5 (PR #20069 by beachball)

9.0.0-alpha.53

Mon, 27 Sep 2021 08:06:00 GMT Compare changes

Changes

• Updates ComponentState on custom props (PR #19981 by bsunderhus@microsoft.com)

9.0.0-alpha.52

Fri, 24 Sep 2021 09:17:17 GMT Compare changes

Changes

• Add as prop to properties allowed with getNativeElementProps (PR #19950 by andredias@microsoft.com)

9.0.0-alpha.51

Thu, 23 Sep 2021 08:21:34 GMT Compare changes

Changes

• Adding clamp and getRTLSafeKey utilities. (commit by czearing@outlook.com)

9.0.0-alpha.50

Wed, 22 Sep 2021 10:10:07 GMT Compare changes

Changes

• Moved from interfaces to types per RFC (commit by gcox@microsoft.com)

9.0.0-alpha.49

Fri, 17 Sep 2021 07:35:26 GMT Compare changes

Changes

• Refactoring out functionality that applies trigger props to children as a utility. (PR #19840 by Humberto.Morimoto@microsoft.com)
• Removes ExtractRef Typings (PR #19840 by bsunderhus@microsoft.com)

9.0.0-alpha.48

Thu, 16 Sep 2021 07:38:39 GMT Compare changes

Changes

• Fix IntrinsicShorthandProps used in the root slot with multiple possible as values (PR #19815 by behowell@microsoft.com)

9.0.0-alpha.47

Tue, 14 Sep 2021 20:09:02 GMT Compare changes

Changes

• Adds ExtractRef typings to react-utilities to extract reference from props (PR #19155 by bsunderhus@microsoft.com)

9.0.0-alpha.46

Fri, 10 Sep 2021 16:31:53 GMT Compare changes

Changes

• chore(v9): Move all internal v9 dependencies from caret to fixed version (PR #19748 by lingfangao@hotmail.com)

9.0.0-alpha.45

Fri, 10 Sep 2021 07:39:51 GMT Compare changes

Changes

• Add IntrinsicShorthandProps for slots that use intrinsic elements like div or span (PR #19642 by behowell@microsoft.com)

9.0.0-alpha.44

Mon, 06 Sep 2021 07:34:53 GMT Compare changes

Changes

• feat(react-utilities): use event.key for keyboard events (PR #19640 by lingfangao@hotmail.com)

9.0.0-alpha.43

Wed, 01 Sep 2021 07:39:56 GMT Compare changes

Changes

• Update implementation to handle 'root' as a slot (PR #19483 by bsunderhus@microsoft.com)

9.0.0-alpha.42

Tue, 31 Aug 2021 07:37:47 GMT Compare changes

Changes

• fix(useOnClickOutside): Treat right click/context menu as outside click (PR #19556 by lingfan.gao@microsoft.com)

9.0.0-alpha.41

Tue, 24 Aug 2021 07:34:48 GMT Compare changes

Changes

• Updating TypeScript type-only imports/exports to use import/export type syntax. (PR #19471 by dzearing@hotmail.com)

9.0.0-alpha.40

Fri, 20 Aug 2021 07:37:28 GMT Compare changes

Changes

• Update .npmignore (PR #19441 by elcraig@microsoft.com)

9.0.0-alpha.39

Thu, 19 Aug 2021 07:41:35 GMT Compare changes

Changes

• Slot null rendering refactor (PR #19273 by bsunderhus@microsoft.com)

9.0.0-alpha.38

Fri, 06 Aug 2021 07:35:14 GMT Compare changes

Changes

• Deletes descendants API (PR #19189 by bsunderhus@microsoft.com)

9.0.0-alpha.37

Tue, 03 Aug 2021 07:39:30 GMT Compare changes

Patches

• Bump @fluentui/eslint-plugin to v1.3.3 (PR #19169 by behowell@microsoft.com)
• Bump @fluentui/keyboard-key to v0.3.4 (PR #19169 by behowell@microsoft.com)
• Bump @fluentui/scripts to v1.0.0 (PR #19169 by behowell@microsoft.com)

Changes

• Copying useMount and useUnmount hooks into the react-utilities package. (PR #19196 by czearing@outlook.com)

9.0.0-alpha.36

Mon, 02 Aug 2021 07:36:20 GMT Compare changes

Changes

• feat(useOnClickOutside): Handle clicks into an iframe (PR #19204 by lingfan.gao@microsoft.com)

9.0.0-alpha.35

Fri, 23 Jul 2021 07:38:19 GMT Compare changes

Changes

• Improve type safety of the onlyChild function (PR #18610 by behowell@microsoft.com)

9.0.0-alpha.34

Thu, 22 Jul 2021 07:36:55 GMT Compare changes

Changes

• Move useTimeout into react-utilities and add tests (PR #19023 by behowell@microsoft.com)

9.0.0-alpha.33

Thu, 15 Jul 2021 07:36:18 GMT Compare changes

Changes

• Fix bugs on getSlots to follow with RFC (PR #18861 by bsunderhus@microsoft.com)
• feat(useControllableState): deprecate useControlledValue with new hook (PR #18881 by lingfan.gao@microsoft.com)

9.0.0-alpha.32

Fri, 09 Jul 2021 07:39:31 GMT Compare changes

Patches

• Bump @fluentui/eslint-plugin to v1.3.2 (PR #18808 by martinhochel@microsoft.com)
• Bump @fluentui/keyboard-key to v0.3.3 (PR #18808 by martinhochel@microsoft.com)
• Bump @fluentui/scripts to v1.0.0 (PR #18808 by martinhochel@microsoft.com)

9.0.0-alpha.31

Fri, 02 Jul 2021 23:15:55 GMT Compare changes

Changes

• Add new prop mergin mechanism (PR #18721 by bsunderhus@microsoft.com)
• chore(Menu): use capture event to handle outside click (PR #18792 by lingfan.gao@microsoft.com)

9.0.0-alpha.30

Fri, 02 Jul 2021 07:37:06 GMT Compare changes

Changes

• Rename typings and getSlots to have the Compat Suffix (PR #18796 by bsunderhus@microsoft.com)

9.0.0-alpha.29

Tue, 15 Jun 2021 07:40:20 GMT Compare changes

Changes

• Remove boolean from ShorthandProps type (PR #18521 by behowell@microsoft.com)

9.0.0-alpha.28

Mon, 07 Jun 2021 07:38:15 GMT Compare changes

Patches

• Bump @fluentui/eslint-plugin to v1.3.1 (PR #18437 by martinhochel@microsoft.com)
• Bump @fluentui/keyboard-key to v0.3.2 (PR #18437 by martinhochel@microsoft.com)
• Bump @fluentui/scripts to v1.0.0 (PR #18437 by martinhochel@microsoft.com)

9.0.0-alpha.27

Fri, 04 Jun 2021 07:37:23 GMT Compare changes

Changes

• Moving onlyChild to @fluentui/react-utilities and adding tests. (PR #18168 by Humberto.Morimoto@microsoft.com)

9.0.0-alpha.26

Fri, 28 May 2021 07:33:57 GMT Compare changes

Changes

• useOnScrollOutside hook to detect scroll outside a component (PR #18312 by lingfan.gao@microsoft.com)

9.0.0-alpha.25

Wed, 26 May 2021 07:35:43 GMT Compare changes

Changes

• useOnClickOutside, workaround for facebook/react#20074 (PR #18323 by lingfan.gao@microsoft.com)

9.0.0-alpha.24

Fri, 21 May 2021 07:34:54 GMT Compare changes

Changes

• Refactor ComponentState to remove ref template parameter (PR #18259 by behowell@microsoft.com)

9.0.0-alpha.23

Thu, 20 May 2021 07:41:54 GMT Compare changes

Patches

• Bump @fluentui/eslint-plugin to v1.3.0 (PR #18024 by elcraig@microsoft.com)
• Bump @fluentui/keyboard-key to v0.3.1 (PR #18024 by elcraig@microsoft.com)
• Bump @fluentui/scripts to v1.0.0 (PR #18024 by elcraig@microsoft.com)

Changes

• ComponentState: fix shadowing and doc syntax for type params (PR #18024 by elcraig@microsoft.com)

9.0.0-alpha.22

Wed, 19 May 2021 07:34:20 GMT Compare changes

Changes

• chore: add more Babel plugins (PR #18037 by olfedias@microsoft.com)
• Support custom contains check (PR #18148 by lingfan.gao@microsoft.com)

9.0.0-alpha.21

Mon, 03 May 2021 07:45:19 GMT Compare changes

Changes

• useOnClickOutside can be disabled (PR #18005 by lingfan.gao@microsoft.com)

9.0.0-alpha.20

Fri, 30 Apr 2021 07:42:23 GMT Compare changes

Patches

• Bump @fluentui/eslint-plugin to v1.2.0 (PR #17932 by joschect@microsoft.com)
• Bump @fluentui/keyboard-key to v0.3.0 (PR #17932 by joschect@microsoft.com)
• Bump @fluentui/scripts to v1.0.0 (PR #17932 by joschect@microsoft.com)

Changes

• Upgrade to ts 4.0 (PR #17932 by joschect@microsoft.com)
• update useId() to be safe for SSR (PR #17924 by olfedias@microsoft.com)

9.0.0-alpha.19

Fri, 23 Apr 2021 07:37:10 GMT Compare changes

Patches

• Bump @fluentui/eslint-plugin to v1.1.1 (PR #17894 by olfedias@microsoft.com)
• Bump @fluentui/keyboard-key to v0.2.17 (PR #17894 by olfedias@microsoft.com)
• Bump @fluentui/scripts to v1.0.0 (PR #17894 by olfedias@microsoft.com)

9.0.0-alpha.18

Thu, 22 Apr 2021 07:33:28 GMT Compare changes

Changes

• dedupe isSSR definitions (PR #17897 by olfedias@microsoft.com)
• Remove default document in useOnClickOutside (PR #17898 by lingfan.gao@microsoft.com)

9.0.0-alpha.17

Wed, 21 Apr 2021 07:31:50 GMT Compare changes

Changes

• Rename ax() to mergeClasses() (PR #17875 by miroslav.stastny@microsoft.com)

9.0.0-alpha.16

Fri, 16 Apr 2021 18:08:21 GMT Compare changes

Changes

• Extract usePrevious from descendants (PR #17794 by lingfan.gao@microsoft.com)

9.0.0-alpha.15

Thu, 01 Apr 2021 20:13:37 GMT Compare changes

Changes

• Adds isSSR method to react-utilities (PR #17651 by bsunderhus@microsoft.com)

9.0.0-alpha.14

Wed, 31 Mar 2021 00:53:43 GMT Compare changes

Patches

• Bump @fluentui/eslint-plugin to v1.1.0 (PR #17568 by elcraig@microsoft.com)
• Bump @fluentui/keyboard-key to v0.2.16 (PR #17568 by elcraig@microsoft.com)
• Bump @fluentui/scripts to v1.0.0 (PR #17568 by elcraig@microsoft.com)

Changes

• Add ComponentState helper type; improve type checking for makeMergeProps (PR #17508 by behowell@microsoft.com)
• Add shouldPreventDefaultOnKeyDown utility function to detect keyboard clicks (PR #17572 by lingfan.gao@microsoft.com)

9.0.0-alpha.13

Tue, 30 Mar 2021 07:34:45 GMT Compare changes

Changes

• chore: restore "sideEffects" to enable treeshaking (PR #17584 by olfedias@microsoft.com)

9.0.0-alpha.12

Fri, 26 Mar 2021 07:32:34 GMT Compare changes

Changes

• Add descendants utility (PR #17524 by lingfan.gao@microsoft.com)

9.0.0-alpha.11

Thu, 25 Mar 2021 07:33:24 GMT Compare changes

Changes

• Move descendants to react-utilities (PR #17528 by lingfan.gao@microsoft.com)

9.0.0-alpha.10

Tue, 23 Mar 2021 07:31:43 GMT Compare changes

Changes

• Add useCallbackRef and useFirstMount hooks (PR #17339 by lingfan.gao@microsoft.com)

9.0.0-alpha.9

Thu, 18 Mar 2021 20:15:34 GMT Compare changes

Changes

• Add onUseClickOutside hook (PR #17387 by lingfan.gao@microsoft.com)

9.0.0-alpha.8

Mon, 15 Mar 2021 07:36:20 GMT Compare changes

Changes

• Remove set-version references (PR #17381 by elcraig@microsoft.com)

9.0.0-alpha.7

Wed, 10 Mar 2021 07:34:39 GMT Compare changes

Changes

• useControllableValue should behave natively (PR #17293 by lingfan.gao@microsoft.com)

9.0.0-alpha.6

Fri, 05 Mar 2021 20:30:59 GMT Compare changes

Changes

• useIsomorphicLayout effect with useEventCallback (PR #17273 by lingfan.gao@microsoft.com)

9.0.0-alpha.5

Wed, 03 Mar 2021 00:10:09 GMT Compare changes

Patches

• Bump @fluentui/jest-serializer-merge-styles to v8.0.2 (PR #17246 by elcraig@microsoft.com)

Changes

• Remove set-version dependency from converged components (PR #17211 by miroslav.stastny@microsoft.com)

9.0.0-alpha.4

Tue, 02 Mar 2021 07:24:27 GMT Compare changes

Changes

• remove dependency on @fluentui/utilities (PR #17197 by olfedias@microsoft.com)

9.0.0-alpha.3

Fri, 26 Feb 2021 01:16:27 GMT Compare changes

Patches

• Bump @fluentui/eslint-plugin to v1.0.1 (PR #17169 by elcraig@microsoft.com)
• Bump @fluentui/scripts to v1.0.0 (PR #17169 by elcraig@microsoft.com)
• Bump @fluentui/jest-serializer-merge-styles to v8.0.1 (PR #17169 by elcraig@microsoft.com)
• Bump @fluentui/set-version to v8.0.1 (PR #17169 by elcraig@microsoft.com)
• Bump @fluentui/utilities to v8.0.1 (PR #17169 by elcraig@microsoft.com)

Changes

• Update references to major-bumped packages (PR #17169 by elcraig@microsoft.com)

9.0.0-alpha.2

Thu, 25 Feb 2021 01:15:27 GMT Compare changes

Changes

• Remove dep array from useEventCallback (PR #17113 by lingfan.gao@microsoft.com)

9.0.0-alpha.1

Wed, 24 Feb 2021 00:05:29 GMT Compare changes

Changes

• bump version to v9 (PR #17093 by olfedias@microsoft.com)

0.4.0

Mon, 22 Feb 2021 12:26:22 GMT Compare changes

Minor changes

• Breaks dependency on react-hooks for convergence (PR #17091 by lingfan.gao@microsoft.com)

Patches

• align typings for shorthands (PR #17061 by olfedias@microsoft.com)

Changes

• Bump @fluentui/jest-serializer-merge-styles to v8.0.0-beta.7 (PR #17061 by elcraig@microsoft.com)
• Bump @fluentui/utilities to v8.0.0-beta.15 (PR #17061 by elcraig@microsoft.com)

0.3.1

Thu, 18 Feb 2021 19:38:50 GMT Compare changes

Patches

• Allow React 17 in peerDependencies (PR #17048 by elcraig@microsoft.com)

Changes

• Bump @fluentui/utilities to v8.0.0-beta.14 (PR #17048 by elcraig@microsoft.com)

0.3.0

Thu, 18 Feb 2021 12:27:34 GMT Compare changes

Minor changes

• include all utils from fluentui/react-utils (PR #16970 by olfedias@microsoft.com)

Changes

• Bump @fluentui/eslint-plugin to v1.0.0-beta.2 (PR #16975 by elcraig@microsoft.com)
• Bump @fluentui/utilities to v8.0.0-beta.13 (PR #16975 by elcraig@microsoft.com)
• Bump @fluentui/jest-serializer-merge-styles to v8.0.0-beta.6 (PR #16975 by elcraig@microsoft.com)
• Bump @fluentui/set-version to v8.0.0-beta.2 (PR #16975 by elcraig@microsoft.com)
• Bump @fluentui/scripts to v1.0.0 (PR #16975 by elcraig@microsoft.com)

0.2.4

Mon, 01 Feb 2021 12:23:48 GMT Compare changes

Patches

• add prerelease in disallowed change type for version packages and fix current versioning. (PR #16696 by xgao@microsoft.com)

0.2.4-4

Thu, 28 Jan 2021 12:25:56 GMT Compare changes

Changes

• Updating to webpack 5, latest typings, latest loaders and plugins. (PR #16447 by dzearing@microsoft.com)

0.2.4-3

Thu, 21 Jan 2021 12:36:12 GMT Compare changes

Changes

• Updating dev dependencies. (PR #16548 by dzearing@microsoft.com)

0.2.3

Fri, 23 Oct 2020 03:26:15 GMT Compare changes

Patches

• Rename @uifabric/set-version to @fluentui/set-version (PR #15616 by ololubek@microsoft.com)

Changes

• Add missing version.ts; Remove unneeded package dependencies. (PR #15456 by xgao@microsoft.com)
• Remove react-dom from peerDependencies (PR #15634 by elcraig@microsoft.com)

0.1.1

Tue, 18 Aug 2020 07:58:00 GMT

Patches

• Scaffolding @fluentui/react-utilities package. (PR #14571 by dzearing@hotmail.com)