collab-ui-icons

!npm (scoped)

> Collab UI Icons

Collab UI Icons is a full suite of the pictographic font and svg icons.

Table of Contents

- Background
- Install
- Usage
- CSS
- Scss
- API (CSS)
- Contribute
- License

Background

Collab UI Icons is a full suite of the pictographic icons for easy scalable vector graphics on websites and web applications, created and maintained by the Spark UI Design Language team. It contains the Scss, CSS, fonts and SVG files needed for implenting the icons indepented of any other framework. It is also consumed and published as part of the Collab UI Toolkit.

Install

Install and manage the Spark UI Toolkit's icons using NPM. You may use yarn or npm. By default, yarn/npm installs packages to node_modules/.

yarn add @collab-ui/icons

or

npm install @collab-ui/icons --save

Usage

$3

1. Copy the "@collab-ui/icons/fonts" directory to the "fonts" directory for your site.
2. Copy the "@collab-ui/icons/css/collab-ui-icons.min.css" to your styles/css directory.
3. In the of your HTML reference the location of your collab-ui-icons.min.css.

$3

1. Copy the "@collab-ui/icons/fonts" directory to the "fonts" directory for your site.
2. Add an "$icon-font-path" variable to your variables.scss file.

$icon-font-path: 'path/to/fonts/directory';

3. Import "@collab-ui/icons/scss/collab-ui-icons.scss" into your main entry Scss file AFTER the variables.

@import '@collab-ui/icons/scss/collab-ui-icons.scss';

4. Compile your Scss using your static compiler or bundler

CSS API

$3

You can place Collab UI Icons just about anywhere using the CSS Prefix icon- and the icon's name. Collab UI Icons is designed to be used with inline elements (we like the tag for brevity, but using a is more semantically correct).

$3

All of the Collab UI Icons are suffixed with their size. i.e. icon-camera_16 The CSS will automatically size the icons according to this size.

$3

Use icon-fw to set icons at a fixed width. Great to use when different icon widths throw off alignment. Especially useful in things like nav lists & list groups.

$3

Use icon-ul and icon-li to easily replace default bullets in unordered lists.

$3

Use the icon-spin class to get any icon to rotate, and use icon-pulse to have it rotate with 8 steps.

$3

To arbitrarily rotate and flip icons, use the icon-rotate- and icon-flip- classes.

Contribute

Icon contributions are currently only accepted from the Spark UI Design team.

License

© 2014-2019 Cisco and/or its affiliates. All Rights Reserved.