1
1
mirror of https://github.com/primer/css.git synced 2024-11-30 01:04:04 +03:00
css/modules/primer-progress/README.md
2018-12-17 15:26:50 -08:00

2.6 KiB

Primer / Progress

npm version Build Status

Use Progress components to visualize task completion

This repository is a module of the full primer repository.

Install

This repository is distributed with npm. After installing npm, you can install primer-progress with this command.

$ npm install --save primer-progress

Usage

The source files included are written in Sass (SCSS) You can simply point your sass include-path at your node_modules directory and import it like this.

@import "primer-progress/index.scss";

You can also import specific portions of the module by importing those partials from the /lib/ folder. Make sure you import any requirements along with the modules.

Build

For a compiled CSS version of this module, an npm script is included that will output a css version to build/build.css The built css file is also included in the npm package:

$ npm run build

Documentation

Use Progress components to visualize task completion.

Default Progress

<span class="Progress">
  <span class="Progress-value bg-green" style="width: 50%;"></span>
</span>

Large Progress

<span class="Progress Progress--large">
  <span class="Progress-value bg-green" style="width: 50%;"></span>
</span>

Small Progress

<span class="Progress Progress--small">
  <span class="Progress-value bg-green" style="width: 50%;"></span>
</span>

Progress with tooltip

<div class="tooltipped tooltipped-n" aria-label="78 done / 6 in progress / 2 to do">
  <span class="Progress">
    <span class="Progress-value bg-green" style="width: 50%;"></span>
  </span>
</div>

Progress with multiple values

<div class="tooltipped tooltipped-n" aria-label="78 done / 6 in progress / 2 to do">
  <span class="Progress">
    <span class="Progress-value bg-green" style="width: 50%;"></span>
    <span class="Progress-value bg-purple" style="width: 25%;"></span>
    <span class="Progress-value bg-red" style="width: 5%;"></span>
  </span>
</div>

License

MIT © GitHub