Font Awesome icons as React components
I NEED TO FIX THIS STILL
Installation
React Font Awesome is distributed via npm:
npm install react react-fa
You also need to install webpack which is the only bundler at the moment capable to bundle not only JavaScript code but also stylesheets and static assets such as fonts and images:
npm install webpack
You also need a couple of loaders for webpack:
npm install babel-loader style-loader css-loader url-loader file-loadernpm install extract-text-webpack-plugin
Usage
Just as simple as:
ReactDOM
Icon Component API
Props in []
are optional
Prop | Type | Default | Description |
---|---|---|---|
name | string |
undefined |
Required: Name of the Font Awesome Icon |
[className] | string |
undefined |
Set a CSS class for extra styles |
[size] | string |
undefined |
Increase size: 'lg', '2x', '3x', '4x', '5x' |
[rotate] | string |
undefined |
Rotate by deg: '45', '90', '135', '180', '225', '270', '315' |
[flip] | string |
undefined |
Flips Icon: 'horizontal', 'vertical' |
[fixedWidth] | boolean |
false |
Set Icon to a fixed width |
[spin] | boolean |
false |
Rotate Icon |
[pulse] | boolean |
false |
Rotate Icon in 8 steps |
[stack] | string |
undefined |
Stack Icons: '1x', '2x'. More Info |
[inverse] | boolean |
false |
Inverse the Icon color |
[Component] | string/func |
span |
Alternate DOM element |
IconStack Component API
Prop | Type | Default | Description |
---|---|---|---|
[children] | node |
undefined |
Required: Child elements |
[size] | string |
undefined |
Increase size: 'lg', '2x', '3x', '4x', '5x' |
[className] | string |
undefined |
Set a CSS class for extra styles |
Webpack Setup
Use the following webpack config (put it in webpack.config.js
):
var ExtractTextPlugin = moduleexports = entry: './index.js' output: path: 'assets' filename: 'bundle.js' module: loaders: test: /\.js$/ loader: 'babel' test: /\.css$/ loader: ExtractTextPlugin test: /\.woff??$/ loader: 'url-loader?limit=10000&mimetype=application/font-woff' test: /\.?$/ loader: 'file-loader' plugins: 'bundle.css'
which compile everything (js, stylesheets and icon fonts) into assets/
directory so you would need this basic HTML file to start your app: