Note: Microsoft no longer supports this content and will not be responding to bugs or issues. We recommend that you use the newer version, Office UI Fabric, with React as your front-end framework. If you still need assistance with Fabric.js, visit Stack Overflow/office-ui-fabric.
Latest version: Fabric JS 1.4.0, which uses Fabric Core 5.0.1.
- What's included
- Get started
- View the interactive docs
- Learn more
- Trello board
- Contribute to Fabric
This repository contains simple, visuals-focused components that don't require a framework. For the entire list of components available in Fabric JS, see the component list.
Note: For more information on Office UI Fabric version 2.6.1, which combined Fabric core and Fabric’s components together, see Get started with Fabric 2.6.1.
For a quick start, you can reference the latest release of Fabric from a CDN or clone and build locally. Once you've got Fabric JS added to your project, look at the component list for documentation pertaining to each available component.
If you'd like to get Fabric through a package manager such as Bower, npm, or NuGet, check out the package manager docs.
Referencing the CDN
Include the following references in the
<head> of your page:
<link rel="stylesheet" href="https://static2.sharepointonline.com/files/fabric/office-ui-fabric-js/1.2.0/css/fabric.min.css"> <link rel="stylesheet" href="https://static2.sharepointonline.com/files/fabric/office-ui-fabric-js/1.2.0/css/fabric.components.min.css"> <script src="https://static2.sharepointonline.com/files/fabric/office-ui-fabric-js/1.2.0/js/fabric.min.js"></script>
Note: You may notice an additional reference to the Fabric Core. The components of Fabric JS use styles from Fabric Core.
All releases of Fabric JS are available on the CDN, with new versions typically added within a week of the release. To reference a specific version, update the version number in the URL to match the one you want.
If you want to reference previous versions, please see this get started guide (located in the Core repo).
Clone, build, and view the docs
- Clone the repo
- Navigate to the folder that contains the gulpfile.js file (Fabric JS's root).
The built files will be in the
/dist/ folder. You can then add these built files directly to your project.
You can also navigate to http://localhost:2020 to see the local docs site where you can test out the components' responsive behavior and see the samples.
For more information, check out the documentation on building Fabric JS locally.
New to Fabric? Although the project's site contains lots of great info about its purpose and what's included, most of Fabric JS's documentation is contained in this repository.
To see a full component list, you can check out the component list here or build the project locally to use the fully interactive docs site.
When you're ready to create an Office Add-in with Fabric, take a look at the Use Office UI Fabric with Office Add-ins on MSDN article.
For more information about the React components, check out the Office UI Fabric React repository.
Fabric JS contains a variety of components that are a part of the Office / Office 365 design language. If you're not seeing a component here that you'd like, first check out the Office UI Fabric JS Requests board and upvote it there (if it exists), or file an issue on Fabric JS's issue tracker to kick off a new request.
Contribute to Fabric JS
If you have any style issues - icons, typography, fonts, colors, the grid, etc. - please file them in the Office UI Fabric Core repository.