This framework uses styles from the Office UI Fabric Core project. Fabric is a responsive, mobile-first collection of styles and tools designed to make it quick and simple for you to create web experiences using the Office Design Language.
Latest version: 1.1.0, using Fabric Core 4.0.0.
Latest version on CDN: 1.0.0, using Fabric Core 4.0.0.
- What's included
- Get started
- View the interactive docs
- Learn more
- Trello board
- Contribute to Fabric
- Licenses
- Changelog
This repository contains simple, visuals-focused components that don't require a framework. If you have any issues with core styling - icons, typography, fonts, colors, the grid, etc. - please file them in the Office UI Fabric Core repository. For more information about the React components, check out the Office UI Fabric React repository.
For documentation on Fabric's last stable version that included both the components and the core, check out the Fabric 2.6.1 get started guide (located in the Core repo).
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.
Include the following references in the <head> of your page:
<link rel="stylesheet" href="https://appsforoffice.microsoft.com/fabric/fabric-core/4.0.0/fabric.min.css">
<link rel="stylesheet" href="https://appsforoffice.microsoft.com/fabric/fabric-js/1.0.0/fabric.components.min.css">Note: You may notice an additional reference to the Fabric Core - this is intentional as these styles are almost always needed for experiences where you'd like to use the components, so we recommend including it by default.
New versions of Fabric might not be available on the CDN right away. The following table lists the releases that are available now. To reference a specific version, update the version number in the URL to match the one you want.
| Fabric JS Release | Available on CDN |
|---|---|
| 1.1.0 | No |
| 1.0.0 | Yes |
If you want to reference previous versions, please see this get started guide (located in the Core repo).
Before you get started, make sure you have node.js, gulp, and git installed. To build Fabric:
- Clone the repo
- Navigate to the folder that contains the gulpfile.js file (Fabric JS's root).
npm installgulp watch
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 documentaiton 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.
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.
Bug reports, feature requests, and questions are posted on the issue tracker. For details on our contribution process and how we label issues, see our contributing page.
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 license.
We use GitHub Releases to manage our releases, including the changelog between every release. View a complete list of additions, fixes, and changes since 1.0 on the releases page.
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.