zma-icons

Free iOS-icons font for ZMA

Usage no npm install needed!

<script type="module">
  import zmaIcons from 'https://cdn.skypack.dev/zma-icons';
</script>

README

ZMA Icons

The premium and free iOS-icons font for ZMA.

The font is developed to be used with ZMA, but you can use it wherever you see it fits, personal or commercial. It is free to use and licensed under MIT.

Getting Started

  1. Download and extract the font pack

  2. Copy the zma-icons.css to your project or add this CSS to your own CSS file:

    @font-face {
      font-family: 'ZMA Icons';
      font-style: normal;
      font-weight: 400;
      src: url("../fonts/ZMAIcons-Regular.eot");
      src: local('ZMA Icons'),
         local('ZMAIcons-Regular'),
         url("../fonts/ZMAIcons-Regular.woff2") format("woff2"),
         url("../fonts/ZMAIcons-Regular.woff") format("woff"),
         url("../fonts/ZMAIcons-Regular.ttf") format("truetype");
    }
    
    .zma-icons {
      font-family: 'ZMA Icons';
      font-weight: normal;
      font-style: normal;
      font-size: 28px;
      line-height: 1;
      letter-spacing: normal;
      text-transform: none;
      display: inline-block;
      white-space: nowrap;
      word-wrap: normal;
      direction: ltr;
      -webkit-font-smoothing: antialiased;
      text-rendering: optimizeLegibility;
      -moz-osx-font-smoothing: grayscale;
      -webkit-font-feature-settings: "liga";
      -moz-font-feature-settings: "liga=1";
      -moz-font-feature-settings: "liga";
      font-feature-settings: "liga";
    }
    
  3. Copy the fonts folder to your project

  4. Ensure the font urls within zma-icons.css properly reference the fonts path within your project.

  5. Include a reference to the zma-icons.css file from every webpage you need to use it:

    <link rel="stylesheet" href="path/to/zma-icons.css">
    

Or with component:

$ component install tukida/zma-icons

Or with bower:

$ bower install zma-icons

Or with npm:

$ npm install zma-icons

Webpack

When using webpack, you must add loaders for css and fonts.

{ test: /\.css/, loader: 'style-loader!css-loader' },
{ test: /\.(woff|woff2|eot|ttf)$/, loader: 'url-loader?limit=100000' },

Then you can import the module like so:

import 'zma-icons';

HTML Example

You can use ZMA or included cheatsheet.html file to easily find the icon you want to use. It’s easy to incorporate icons into your web page. Here’s a small example:

<i class="zma-icons">house</i>

This example uses a typographic feature called ligatures, which allows rendering of an icon glyph simply by using its textual name. The replacement is done automatically by the web browser and provides more readable code than the equivalent numeric character reference.

Styling Icons

Sizing

ZMA Icons look best at 28px, but if an icon needs to be displayed in an alternative size, just use CSS font-size rule:

.size-14 { font-size: 14px }
.size-28 { font-size: 28px }
.size-32 { font-size: 32px }
.size-56 { font-size: 56px }
<i class="zma-icons size-14">house</i>
<i class="zma-icons size-28">house</i>
<i class="zma-icons size-32">house</i>
<i class="zma-icons size-56">house</i>

Coloring

Using the icon font allows for easy styling of an icon in any color.

.color-black { color: #000 }
.color-white { color: #fff }
<i class="zma-icons color-black">house</i>
<i class="zma-icons color-white">house</i>

Using in data- attributes

Add the following CSS rule:

.zma-icons[data-icon]:before {
    content: attr(data-icon);
    color: inherit;
}

And now you can use it with data- attributes:

<i class="zma-icons" data-icon="house"></i>

Build Instructions

This repo already comes with all the files built and ready to go, but can also build the fonts from the source. Requires Python, FontForge and woff2:

  1. Install FontForge, which is the program that creates the font files from the SVG files:

    $ brew install fontforge ttfautohint

  2. Install woff2

    $ git clone --recursive https://github.com/google/woff2.git $ cd woff2 $ make clean all

  3. Add or subtract files from the src/ folder you'd like to be apart of the font files.

  4. Run the build command:

    python ./build/generate.py

License

ZMA Icons font is licensed under the MIT license.