font-awesome-list is a Node.js module for getting the list of all icons provided by FontAwesome.
Install using npm:
$ npm install --save font-awesome-listThe version of this library will always match the version of FontAwesome whose icons are listed.
Returns all of the FontAwesome icons.
var fontAwesomeList = require('font-awesome-list');
fontAwesomeList.all();
//=> [ { name: "Glass", id: "glass", unicode: "f000", created: 1, filter: [ "martini", "drink", "bar", "alcohol", "liquor" ], categories: [ "Web Application Icons" ] }, ... ]Returns the FontAwesome icon with the specified id.
id can even be an alias but it must always exactly match. To be safe, always specify using lower case.
A hash lookup is used to find the match icon, so it's really fast.
This method will return null if no icon could be found for id.
var fontAwesomeList = require('font-awesome-list');
fontAwesomeList.get('git');
//=> { name: "Git", id: "git", unicode: "f1d3", created: 4.1, categories: [ "Brand Icons" ] }
fontAwesomeList.get('fa');
//=> { name: "Font Awesome", id: "font-awesome", unicode: "f2b4", created: 4.6, aliases: [ "fa" ], categories: [ "Brand Icons" ] }
fontAwesomeList.get('unknown');
//=> nullReturns the FontAwesome version.
var fontAwesomeList = require('font-awesome-list');
fontAwesomeList.version();
//=> "4.7.0"If you have any problems with this library or would like to see changes currently in development you can do so here.
If you want to contribute, you're a legend! Information on how you can do so can be found in CONTRIBUTING.md. We want your suggestions and pull requests!
A list of contributors can be found in AUTHORS.md.
See LICENSE.md for more information on our MIT license.
