Skip to content
This repository has been archived by the owner on Mar 26, 2019. It is now read-only.

JavaScript components for building experiences for Office and Office 365.

License

Notifications You must be signed in to change notification settings

OfficeDev/office-ui-fabric-js

Repository files navigation

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.

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

Fabric JS is a JavaScript front-end framework which provides visuals-focused components to extend, re-work and use in your Office and Office 365 experiences. Fabric JS uses styles from the Office UI Fabric Core project. Fabric JS is a collection of responsive, mobile-first styles and tools designed to make it quick and simple for you to create web experiences using the Office Design Language.

Latest version: Fabric JS 1.4.0, which uses Fabric Core 5.0.1.

Contents

What's included

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.

Get started

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

Before you get started, make sure you have node.js, gulp, and git installed. To build Fabric:

  1. Clone the repo
  2. Navigate to the folder that contains the gulpfile.js file (Fabric JS's root).
  3. npm install
  4. gulp 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 documentation on building Fabric JS locally.

Learn more

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.

Trello board

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

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.

If you have any style issues - icons, typography, fonts, colors, the grid, etc. - please file them in the Office UI Fabric Core repository.

Licenses

All files in this GitHub repository are subject to the MIT license. This project also references fonts and icons from a CDN, which are subject to a separate asset license.

Changelog

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 opencode@microsoft.com with any additional questions or comments.