Subscribe Free

Join 2670+ others. No spamming.
I promise!

We are currently under high development. Follow us at github.


Looking for Python Tutorials?
Check these awesome tutorials



OfficeDev/Office-UI-Fabric

READ ME

Office UI Fabric

The front-end framework for building experiences for Office and Office 365.

Fabric is a responsive, mobile-first, front-end framework, designed to make it quick and simple for you to create web experiences using the Office Design Language. It’s easy to get up and running with Fabric—whether you’re creating a new Office experience from scratch or adding new features to an existing one.

Contents

Why Office UI Fabric?

  • Fabric embodies the Microsoft Design Language. You get to use the same design language used in Microsoft products, so your experiences feel tightly integrated into Office.
  • Fabric is just like other popular frameworks so it's easy to use. CSS classes, HTML, and JavaScript samples - everything you need to get going building great looking experiences.
  • Fabric is built from the ground up for Office so there is no excessive overriding of pre-existing frameworks.
  • Fabric integrates with other frameworks like Bootstrap. Uniquely namespaced classes prevent conflicts.
  • Fabric is built with LESS for powerful customization.
  • Full language support (including right-to-left behavior) helps take the guesswork out of localization.
  • You get full access to the source code and samples. You can tailor Fabric to your own specific needs.

Why open source?

The Office UI Fabric project is developed and maintained by the OneDrive and SharePoint Design Studio in order to...

  • Help the broader development community build add-ins and applications for Office 365.
  • Provide a point of reference for the evolving Office 365 Design Language.
  • Create a community around the Office 365 UI/UX that contributes to better experiences for everyone who builds for Office.

We will do our best to release frequently and keep the community up-to-date with changes to the Design Language, components, and other assets. We also have to evolve quickly. This means that everyone gets the latest designs, but that features and assets can change often. Deprecated features will be marked in our changelog, and will be removed from the next major release following the deprecation announcement.

Support

If you have any issues, we will do our best to respond but we can't guarantee timely responses. Support is limited.

If you have a specific bug, feature request, or question, post it via the issue tracker. For more information and labels, see our contributing section.

Frequently asked questions

How does Fabric work and where can I see some samples?

Fabric provides the "skin" that you can use to apply the official Microsoft design language to your Office or Office 365 app or add-in. The JavaScript included with Fabric is for demo purposes only - feel free to swap it out with whatever meets your needs.

For details about our samples, see Fabric samples. For information about how to build and watch the Fabric samples, see Building Fabric, gulp tasks, and the starter template.

How does Fabric compare to frameworks like Bootstrap and Foundation?

Fabric solves many of the same problems that other front-end frameworks do, in a way that is specific to Microsoft. We have our own design language and interaction patterns that all Microsoft apps share. Like other frameworks, Fabric speeds up development by ensuring that your add-ins use standard typography, colors, icons, and more. You don't have to spend time overriding the styles of other frameworks. Fabric also includes components the other frameworks don’t have.

Can Fabric co-exist with other frameworks or existing styles?

Yes, Fabric applies styles on an opt-in basis only. It does not style standard HTML elements, like headings and form elements. Namespaced classes prevent conflicts with other frameworks. You can safely add Fabric to an existing add-in or use it alongside another framework of your choice.

A feature I'm using is deprecated. When will it be removed?

Typically, we remove deprecated features from the subsequent major release after we announce the deprecation. For example, you can expect that a feature that is deprecated in version 1.6.0 will no longer be available in version 2.0.

How often do you release Fabric?

We add new features in minor versions (for example, x.Y.z), which we typically release approximately every two weeks. Bug fixes and minor tweaks might be included in patch versions (for example, x.y.Z) which we release as necessary. Whenever we put out a new release, be sure to visit the change log for details about what’s new. This might include breaking changes that you should be aware of.

How is Fabric Licensed?
  • All files on the Office UI Fabric GitHub repository are subject to the MIT license. Please read the License file at the root of the project.
  • Usage of the fonts referenced on Office UI Fabric files is subject to the terms listed here

Documentation

Changelog

We use GitHub Releases to manage our releases, incuding the changelog between every release. View a complete list of additions, fixes, and changes since 1.0 in the Releases section.