Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/seiyria/ng2-fontawesome

An easy-to-use directive for font awesome icons.
https://github.com/seiyria/ng2-fontawesome

List: ng2-fontawesome

angular2 font-awesome icons ng2

Last synced: about 2 months ago
JSON representation

An easy-to-use directive for font awesome icons.

Awesome Lists containing this project

README

        

# ng2-fontawesome
An easy-to-use directive for [font awesome](https://github.com/FortAwesome/Font-Awesome) icons.

# Install
`npm i -s ng2-fontawesome`

# Usage
First, make sure you have a CSS and font loader set up for webpack, like so:
```
{
test: /\.css/,
loader: 'style!css'
},
{
test: /\.woff|\.woff2|\.svg|.eot|\.ttf/,
loader: 'file'
},
```

It is recommended that you globally apply the Font Awesome directive like so:

```
import { provide, PLATFORM_DIRECTIVES } from '@angular/core';
import { FontAwesomeDirective } from 'ng2-fontawesome';
import { bootstrap } from '@angular/platform-browser-dynamic';

bootstrap(MyAppComponent, [
provide(PLATFORM_DIRECTIVES, { useValue: FontAwesomeDirective, multi: true })
]);
```

Doing so will allow you to use the `fa` directive anyhwere. Supposing you don't want to do that, registering it and including it like normal will work as well.

Here is how you would use it in your templates:

```html

```

# Options
Name | Valid Values
---- | ------------
`icon` | Any font awesome icon name
`fw` | `true`, `false`
`size` | `'lg'`, `'2x'`, `'3x'`, `'4x'`, `'5x'`
`spin` | `true`, `false`
`pulse` | `true`, `false`
`rotate`| `'90'`, `'180'`, `'270'`
`flip` | `'vertical'`, `'horizontal'`
`extra` | any other classes you want to attach to this icon