包详细信息

@fluentui/react-motion

microsoft591.4kMIT9.8.1

A package with utilities & motion definitions using Web Animations API

自述文件

Fluent UI Web

Build Status GitHub contributors GitHub top language Twitter Follow

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 npm version npm version npm version
Issues Fluent UI React Components GitHub Issues?label=issues&style=flat-square) Fluent UI React GitHub Issues?label=issues&style=flat-square)%22) Fluent UI Web Components GitHub 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
Watch EP01: Positioning Watch EP02: Styling Watch EP03: Griffel
EP04: Foundational APIs EP05: Theming EP06: Accessible by default
Watch EP04: Foundational APIs Watch EP05: Theming Watch 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-motion

This log was last generated on Wed, 18 Jun 2025 17:29:30 GMT and should not be manually modified.

9.8.1

Wed, 18 Jun 2025 17:29:30 GMT Compare changes

Patches

  • Bump @fluentui/react-shared-contexts to v9.24.0 (PR #34675 by beachball)
  • Bump @fluentui/react-utilities to v9.21.1 (PR #34675 by beachball)

9.8.0

Thu, 12 Jun 2025 09:43:33 GMT Compare changes

Minor changes

  • Bump @fluentui/react-utilities to v9.21.0 (PR #34456 by beachball)

9.7.4

Fri, 06 Jun 2025 13:15:17 GMT Compare changes

Patches

  • Bump @fluentui/react-utilities to v9.20.0 (PR #34572 by beachball)

9.7.3

Wed, 14 May 2025 18:49:18 GMT Compare changes

Patches

  • Export child context (PR #34449 by charles.assuncao@microsoft.com)

9.7.2

Wed, 16 Apr 2025 19:42:02 GMT Compare changes

Patches

  • fix: improve element validation to work with React 19 (PR #34164 by olfedias@microsoft.com)
  • Bump @fluentui/react-utilities to v9.19.0 (PR #34166 by beachball)

9.7.1

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

Patches

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

9.7.0

Wed, 26 Mar 2025 21:47:46 GMT Compare changes

Minor changes

  • fix(motion): make createPresenceComponentVariant support motion arrays (PR #33996 by robertpenner@microsoft.com)

Patches

  • fix: handle error cases in "element.animate()" (PR #34096 by seanmonahan@microsoft.com)

9.6.10

Thu, 20 Mar 2025 09:34:58 GMT Compare changes

Patches

  • feat: experimental createInterruptablePresence() (PR #33994 by olfedias@microsoft.com)

9.6.9

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

Patches

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

9.6.8

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

Patches

  • fix: apply initial styles consistently (PR #33810 by olfedias@microsoft.com)
  • Bump @fluentui/react-shared-contexts to v9.22.0 (PR #33927 by beachball)
  • Bump @fluentui/react-utilities to v9.18.21 (PR #33927 by beachball)

9.6.7

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

Patches

  • feat: add extended support for reduced motion (PR #33353 by olfedias@microsoft.com)
  • Bump @fluentui/react-utilities to v9.18.20 (PR #33631 by beachball)

9.6.6

Wed, 08 Jan 2025 18:33:34 GMT Compare changes

Patches

  • fix: handle case when Animation.persist() does not exist (PR #33282 by seanmonahan@microsoft.com)

9.6.5

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

Patches

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

9.6.4

Mon, 09 Dec 2024 17:38:13 GMT Compare changes

Patches

  • fix: avoid memory leak in Animation:finished (PR #33431 by olfedias@microsoft.com)

9.6.3

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

Patches

  • Bump @fluentui/react-shared-contexts to v9.21.1 (PR #33372 by beachball)
  • Bump @fluentui/react-utilities to v9.18.18 (PR #33372 by beachball)

9.6.2

Thu, 28 Nov 2024 09:30:51 GMT Compare changes

Patches

  • fix: respect reduced motion in createMotionComponent() (PR #33357 by olfedias@microsoft.com)

9.6.1

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

Patches

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

9.6.0

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

Minor changes

  • feat: export MotionParam type (PR #32939 by robertpenner@microsoft.com)
  • Bump @fluentui/react-shared-contexts to v9.20.2 (PR #32999 by beachball)
  • Bump @fluentui/react-utilities to v9.18.16 (PR #32999 by beachball)

9.5.2

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

Patches

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

9.5.1

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

Patches

  • Bump @fluentui/react-utilities to v9.18.14 (PR #32494 by beachball)

9.5.0

Fri, 16 Aug 2024 10:24:17 GMT Compare changes

Minor changes

  • feat: Add context to configure motion behaviour (PR #32316 by lingfangao@hotmail.com)

9.4.0

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

Minor changes

  • feat: add presenceMotionSlot() API (PR #31984 by olfedias@microsoft.com)
  • Bump @fluentui/react-shared-contexts to v9.20.0 (PR #32067 by beachball)
  • Bump @fluentui/react-utilities to v9.18.13 (PR #32067 by beachball)

Patches

  • fix: improve Web Animations API detection in tests (PR #32029 by olfedias@microsoft.com)

9.3.0

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

Minor changes

  • feat(motion): add PresenceDirection type (PR #31958 by olfedias@microsoft.com)
  • Bump @fluentui/react-shared-contexts to v9.19.1 (PR #31998 by beachball)
  • Bump @fluentui/react-utilities to v9.18.12 (PR #31998 by beachball)

Patches

  • fix: revert incorectly set npm versions in all packages (PR #31937 by martinhochel@microsoft.com)
  • feat: add createPresenceComponentVariant() (PR #31943 by olfedias@microsoft.com)

9.2.2

Thu, 04 Jul 2024 15:14:35 GMT Compare changes

Patches

  • fix: Check if DOM is available before using Element global to avoid breaks in build. (PR #31907 by estebanmu@microsoft.com)

9.2.1

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

Patches

  • chore: add eslint react-compiler (PR #31457 by seanmonahan@microsoft.com)
  • fix: improve Jest compat (PR #31715 by olfedias@microsoft.com)
  • chore: adds 'use no memo' directive (PR #31787 by seanmonahan@microsoft.com)
  • Bump @fluentui/react-utilities to v9.18.11 (PR #31861 by beachball)

9.2.0

Mon, 17 Jun 2024 07:34:16 GMT Compare changes

Minor changes

  • feat: Implement onMotionCancel callback handler (PR #31698 by lingfangao@hotmail.com)

9.1.0

Wed, 12 Jun 2024 13:17:19 GMT Compare changes

Minor changes

  • feat: add support for params (PR #31566 by olfedias@microsoft.com)
  • feat: Add consistent start and finish lifecycle callbacks (PR #31644 by lingfangao@hotmail.com)

Patches

  • fix(motions): improve compat for jsdom & jest (PR #31602 by olfedias@microsoft.com)

9.0.0

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

Minor changes

  • feat: release stable (PR #31574 by olfedias@microsoft.com)
  • Bump @fluentui/react-utilities to v9.18.10 (PR #31586 by beachball)

0.3.2

Mon, 20 May 2024 12:44:59 GMT Compare changes

Patches

  • chore(motions): add mock for .animate() calls (PR #31390 by olfedias@microsoft.com)
  • Bump @fluentui/react-shared-contexts to v9.19.0 (PR #26682 by beachball)
  • Bump @fluentui/react-utilities to v9.18.9 (PR #26682 by beachball)

0.3.1

Thu, 16 May 2024 09:25:16 GMT Compare changes

Patches

  • fix(motions): use useFirstMount() in createPresenceComponent() (PR #31379 by olfedias@microsoft.com)

0.3.0

Thu, 09 May 2024 19:35:11 GMT Compare changes

Minor changes

  • BREAKING: fix motion token values and adjust structure to match original source (PR #31262 by robert@robertpenner.com)

0.2.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)
  • Bump @fluentui/react-utilities to v9.18.8 (PR #31271 by beachball)

0.2.7

Thu, 02 May 2024 11:36:35 GMT Compare changes

Patches

  • fix(PresenceGroup): cleanup children properly (PR #31175 by olfedias@microsoft.com)
  • chore: improve state handling in createPresenceComponent() (PR #31143 by olfedias@microsoft.com)

0.2.6

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

Patches

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

0.2.5

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

Patches

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

0.2.4

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

Patches

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

0.2.3

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

Patches

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

0.2.2

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

Patches

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

0.2.1

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

Patches

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

0.2.0

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

Minor changes

  • BREAKING: rename createAtom() to createMotionComponent() & createPresence() to createPresenceMotion() (PR #30550 by olfedias@microsoft.com)
  • BREAKING: remove exports for atom & presence definitions (PR #30548 by olfedias@microsoft.com)
  • Bump @fluentui/react-utilities to v9.18.1 (PR #30543 by beachball)

Patches

  • feat: add onMotionFinish() callback to createPresenceComponent() (PR #30529 by olfedias@microsoft.com)
  • feat: add PresenceGroup component (PR #30543 by olfedias@microsoft.com)

0.1.1

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

Patches

  • Bump @fluentui/react-utilities to v9.18.0 (PR #29983 by beachball)

0.1.0

Tue, 23 Jan 2024 15:10:59 GMT

Minor changes

  • chore: initial release (PR #30359 by olfedias@microsoft.com)
  • Bump @fluentui/react-utilities to v9.17.0 (PR #30359 by beachball)