@bravobit/icon-font-generator

1.1.3 • Public • Published

@bravobit/icon-font-generator

Very easy icon font generator.

npm version npm license

  • Use ⌘ Command + F or ctrl + F to search for a keyword.
  • Contributions welcome, please see contribution guide.

Features

  • Easy implementation
  • Library can be consumed by command line and Node
  • The generated font can be used in HTML/CSS

Installation

To use the icon font generator in your own project install it via npm:

$ npm install @bravobit/icon-font-generator --save

How to use (command-line)

$ icon-font-generator --input icons --output out --name myfontname
Argument Alt Description
--input -i The input directory with the SVG icons.
--output -o The output directory for the fonts.
--name -n The name for the font.
--type -t The type to generate (can be added multiple times).

How to use (node)

const iconFontGenerator = require('@bravobit/icon-font-generator');
const path = require('path');

async function main() {
    const inputDirectory = path.join(process.cwd(), '<input-directory>');
    const outputDirectory = path.join(process.cwd(), '<output-directory>');

    await iconFontGenerator({
        input: inputDirectory,
        output: outputDirectory,
        name: '<font-name>',
        types: ['svg', 'ttf']
    });

    console.log('done.');
}

main();
Argument Description Default value
input The input directory with the SVG icons. n/a
output The output directory for the fonts. n/a
name The name for the font. default
types The font types that will be created in the output directory. ['svg', 'ttf', 'woff', 'woff2', 'eot']

How to use (CSS)

Add the @font-face and ::before styling to your stylesheet.

@font-face {
    font-weight: normal;
    font-display: block;
    font-family: 'icon-font';
    src: url('<font-name>.eot'),
         url('<font-name>.eot?#iefix') format('embedded-opentype'),
         url('<font-name>.woff2') format('woff2'),
         url('<font-name>.woff') format('woff'),
         url('<font-name>.ttf') format('truetype'),
         url('<font-name>.svg') format('svg');
}

.icon-font::before {
    display: flex;
    direction: ltr;
    line-height: 1;
    width: inherit;
    height: inherit;
    word-wrap: normal;
    font-size: inherit;
    font-style: normal;
    font-weight: normal;
    white-space: nowrap;
    text-transform: none;
    letter-spacing: normal;
    vertical-align: middle;
    content: attr(data-icon);
    font-family: 'icon-font';
    font-feature-settings: 'liga';
    text-rendering: optimizeLegibility;
    -moz-osx-font-smoothing: grayscale;
    -webkit-font-smoothing: antialiased;
}

Because of de content data-icon property you can enter the icon name in the HTML.

<div class="icon-font" 
     data-icon="<icon-name>">
</div>

License

Distributed under the MIT License. See LICENSE for more information.

Package Sidebar

Install

npm i @bravobit/icon-font-generator

Weekly Downloads

8

Version

1.1.3

License

MIT

Unpacked Size

14.7 kB

Total Files

14

Last publish

Collaborators

  • stanvanheumen