fluentui README

The project's README from github.com/microsoft/fluentui. As one markdown file: README.md.

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 Fluent UI React GitHub Issues 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 and reached End Of Life in July 2025.

For more details about Fluent UI React Northstar, see its source and README.md.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

fluentui (microsoft/fluentui)

Searching Database…

20.3K ·GitHub
Fluentui
这是什么?Fluent UI web 是微软的一套工具库、React 组件和 Web Components,用于构建网页应用,它也是 Microsoft 365、Office 和 Edge 背后的设计系统。
它是一个库还是三个独立的库?一个仓库,三个项目:React Components v9(Microsoft 365 在用)、React v8(Office 在用)和 Web Components(Edge 在用)。每一项都作为独立的 npm 包发布。
怎么把它加到我的应用里?从 npm 安装你想要的那条产品线:@fluentui/react-components 是 v9,@fluentui/react 是成熟的 v8,@fluentui/web-components 则是不依赖框架的 Web Components。
必须搭配 React 使用吗?React 相关的包自然需要 React。web-components 包基于标准 Web Components 构建,所以在 React 之外的其他框架或纯 HTML 页面里也能用。
好像有两个 React 版本,我该用哪个?这里并排存在两代 React 版本:v8 成熟且使用广泛,但 v9 是最终稳定版本,微软鼓励大家迁移到 v9。
只有网页版,还是有原生版本?只有网页版。整个集合都面向网页应用,这个仓库里没有任何原生 iOS 或 Android 组件。
整体都能在 MIT 协议下使用吗?代码是 MIT 协议,但字体和图标不是:它们的使用受单独的资源许可协议约束,所以在发布产品前请先查看那些条款。
Office UI Fabric 和 Northstar 后来怎么样了?Office UI Fabric React 演变成了 Fluent UI:旧仓库现在会跳转到 microsoft/fluentui,它的库以 @fluentui/react 的形式延续下去。Northstar 则被 v9 取代,并于 2025 年 7 月终止维护。
迁移期间可以同时使用 v8 和 v9 的组件吗?可以,README 明确支持把 v9 和 v8(甚至 v0)混用,这样你可以逐步迁移到 v9,而不必一次性重写整个界面。
在哪里可以了解这些组件背后的设计思路?FluentUI Insights 视频系列分六集讲了这些内容:定位、样式、Griffel、基础 API、主题,以及默认无障碍。
这个项目还在积极维护吗?是的。v9 已发布最终稳定版本,仓库运行着 bundle-size 和 package-check 持续集成,而且 Microsoft 365 本身也被列为 v9 组件的使用者。
What are similar projects?Semantic-UI-React, arc-library, base-ui, chakra-ui, shoelace, blueprint, react-icons, bootstrap-vue
Which topics is it in?fluent, web-components, react-components, icons, components, design-system, microsoft, accessibility, component-library, ui-components, ui, web-app
Creator
microsoft
Size
844.4 MB
Stars
20.3K
Updated
CommitOct 16Release@fluentui/utilities_v8.17.3Oct 01
Age
10y
Commits · 90 Days