<style type="text/css">
{{>index-css}}
</style>

<div class="intro">
    <p>
    {{description}}
    </p>
    <p>
       <b>Notes:</b>
       <ul>
           <li>You need to load this module <u>together with 'gallerycss-itsa-base'</u> in order to work.</li>
           <li>These fonticons always need to be declared inside a <u>i-element</u>, see the examples.</li>
           <li>Special thanks to <a href='http://fontello.com' target='_blank'>http://fontello.com</a> by which means this gallerymodule is created</li>
       </ul>
    </p>
</div>

{{>getting-started}}

<h2>Description</h2>
<p>By adding this module, you have some classnames at your proposal, which can be used to create icons. The css only works if you define an empty <code>i-element</code> and add the right class to it. Typically the icons are inside a <code>button-element</code> but this is not required.
</p>
<p>
    Be aware of the load-delay. Iconfonts-modules have are relative big-sized. To speed up initial loading, it is advizable to load the css-modules in a second separate Y.use() statement without a callback.
</p>

<h2>Available iconclasses</h2>
    <ul>
        <li><i class="itsaicon-controll-adduser"> </i><code>itsaicon-controll-adduser</code></li>
        <li><i class="itsaicon-controll-archive"> </i><code>itsaicon-controll-archive</code></li>
        <li><i class="itsaicon-controll-attention"> </i><code>itsaicon-controll-attention</code></li>
        <li><i class="itsaicon-controll-camera"> </i><code>itsaicon-controll-camera</code></li>
        <li><i class="itsaicon-controll-copy"> </i><code>itsaicon-controll-copy</code></li>
        <li><i class="itsaicon-controll-cut"> </i><code>itsaicon-controll-cut</code></li>
        <li><i class="itsaicon-controll-flag"> </i><code>itsaicon-controll-flag</code></li>
        <li><i class="itsaicon-controll-folder"> </i><code>itsaicon-controll-folder</code></li>
        <li><i class="itsaicon-controll-help"> </i><code>itsaicon-controll-help</code></li>
        <li><i class="itsaicon-controll-home"> </i><code>itsaicon-controll-home</code></li>
        <li><i class="itsaicon-controll-info"> </i><code>itsaicon-controll-info</code></li>
        <li><i class="itsaicon-controll-info2"> </i><code>itsaicon-controll-info2</code></li>
        <li><i class="itsaicon-controll-lock"> </i><code>itsaicon-controll-lock</code></li>
        <li><i class="itsaicon-controll-minus"> </i><code>itsaicon-controll-minus</code></li>
        <li><i class="itsaicon-controll-minus-round"> </i><code>itsaicon-controll-minus-round</code></li>
        <li><i class="itsaicon-controll-movie"> </i><code>itsaicon-controll-movie</code></li>
        <li><i class="itsaicon-controll-music"> </i><code>itsaicon-controll-music</code></li>
        <li><i class="itsaicon-controll-paste"> </i><code>itsaicon-controll-paste</code></li>
        <li><i class="itsaicon-controll-pin"> </i><code>itsaicon-controll-pin</code></li>
        <li><i class="itsaicon-controll-plus"> </i><code>itsaicon-controll-plus</code></li>
        <li><i class="itsaicon-controll-plus-round"> </i><code>itsaicon-controll-plus-round</code></li>
        <li><i class="itsaicon-controll-print"> </i><code>itsaicon-controll-print</code></li>
        <li><i class="itsaicon-controll-remove"> </i><code>itsaicon-controll-remove</code></li>
        <li><i class="itsaicon-controll-search"> </i><code>itsaicon-controll-search</code></li>
        <li><i class="itsaicon-controll-settings"> </i><code>itsaicon-controll-settings</code></li>
        <li><i class="itsaicon-controll-spin"> </i><code>itsaicon-controll-spin</code></li>
        <li><i class="itsaicon-controll-spin2"> </i><code>itsaicon-controll-spin2</code></li>
        <li><i class="itsaicon-controll-spin3"> </i><code>itsaicon-controll-spin3</code></li>
        <li><i class="itsaicon-controll-spin4"> </i><code>itsaicon-controll-spin4</code></li>
        <li><i class="itsaicon-controll-spin5"> </i><code>itsaicon-controll-spin5</code></li>
        <li><i class="itsaicon-controll-spin6"> </i><code>itsaicon-controll-spin6</code></li>
        <li><i class="itsaicon-controll-spin7"> </i><code>itsaicon-controll-spin7</code></li>
        <li><i class="itsaicon-controll-tools"> </i><code>itsaicon-controll-tools</code></li>
        <li><i class="itsaicon-controll-unlock"> </i><code>itsaicon-controll-unlock</code></li>
        <li><i class="itsaicon-controll-user"> </i><code>itsaicon-controll-user</code></li>
        <li><i class="itsaicon-controll-users"> </i><code>itsaicon-controll-users</code></li>
        <li><i class="itsaicon-controll-volume-down"> </i><code>itsaicon-controll-volume-down</code></li>
        <li><i class="itsaicon-controll-volume-off"> </i><code>itsaicon-controll-volume-off</code></li>
        <li><i class="itsaicon-controll-volume-up"> </i><code>itsaicon-controll-volume-up</code></li>
    </ul>

<h2>Usage</h2>
```html
<button class="itsabutton-iconleft"><i class="itsaicon-controll-adduser"></i>Add user</button>
```

```js
YUI(yuiconfig).use('yui-base', function(Y) {
    Y.use('gallerycss-itsa-base', 'gallerycss-itsa-controll'); // now the iconfonts will load asynchroniously

    // code can be executed
    ...

});
```
<h3>Changing size</h3>
<p>Iconfonts are handled as regular characters. The font size is detemined by the calculated font-size value of the element. To change the icon-size, you need to change the font-size.
</p>
<p>
The iconfont has its definition inside <code>.itsaicon-iconname:before</code>. You can set a fontsize here, or at a ancestor-node, depending what needs to be set.
</p>
```css
button {
    font-size: 120%;
}
.itsaicon-controll-adduser:before {
    font-size: 150%;
}
```

<h3>Changing color</h3>
<p>Iconfonts are handled as regular characters. The iconcolor is detemined by the calculated color-value of the element. To change the icon-color, you need to change the color of the icon.
</p>
<p>
The icon-color has its definition inside <code>.itsaicon-iconname:before</code>. You can set a color here, or at a ancestor-node, depending what needs to be set.
</p>
```css
button {
    color: #F00;
}
.itsaicon-controll-adduser:before {
    color: #0F0;
}
```
<h2>Creating imagebuttons (purecss compatible)</h2>
    <p>
        Imagebuttons can be created by creating a button and add an empty <code>i-element</code> inside. To be sure the space arround the iconfont gets right, you need to add the right classname to the button as well.
    </p>
    <p>
        These iconfonts work perfectly well with pure-css. So you can add the class <code>pure-button</code> to the button-element. But you don't need to.
    </p>

<h3>Iconbuttons without text</h3>
```html
<button<i class="itsaicon-controll-adduser"></i></button>
```

<h3>Textbuttons with a left-icon</h3>
```html
<button class="itsabutton-iconleft"><i class="itsaicon-controll-adduser"></i>Add user</button>
```

<h3>Textbuttons with a right-icon</h3>
```html
<button class="itsabutton-iconright">Add user<i class="itsaicon-controll-adduser"></i></button>
```

<h3>Rounded buttons with a border</h3>
    <p>
        Bordered and rounded buttons can be made by using special button-classes supllied by <a href='http://gallerydocs.itsasbreuk.nl/gallerycss-itsa-base/index.html' target='_blank>'>gallerycss-itsa-base</a>.
    </p>
```html
<button class="pure-button itsabutton-bordered itsabutton-rounded"><i class="itsaicon-controll-adduser"></i></button>
```
<h2>Licences</h2>
    Copyright (c) 2013 <a href="http://itsasbreuk.nl">Its Asbreuk</a><br />
    Copyright (c) 2013 <a href="http://developer.yahoo.com/yui/license.html">YUI BSD License</a>
<h3>Font licence info</h3>
<ul class='disc'>
   <li>Entypo<br />
           Copyright (C) 2012 by Daniel Bruce<br />
           Author:    Daniel Bruce<br />
           License:   CC BY-SA (<a href='http://creativecommons.org/licenses/by-sa/2.0/' target='_blank'>http://creativecommons.org/licenses/by-sa/2.0/</a>)<br />
           Homepage:  <a href='http://www.entypo.com' target='_blank'>http://www.entypo.com</a></li>
   <li>Font Awesome<br />
           Copyright (C) 2012 by Dave Gandy<br />
           Author:    Dave Gandy<br />
           License:   SIL ()<br />
           Homepage:  /<a href='http://fortawesome.github.com/Font-Awesome' target='_blank'>http://fortawesome.github.com/Font-Awesome</a></li>
   <li>Modern Pictograms<br />
           Copyright (c) 2012 by John Caserta. All rights reserved.<br />
           Author:    John Caserta<br />
           License:   SIL (<a href='http://scripts.sil.org/OFL' target='_blank'>http://scripts.sil.org/OFL</a>)<br />
           Homepage:  <a href='http://thedesignoffice.org/project/modern-pictograms/' target='_blank'>http://thedesignoffice.org/project/modern-pictograms/</a></li>
   <li>Fontelico<br />
           Copyright (C) 2012 by Fontello project<br />
           Author:    Crowdsourced, for Fontello project<br />
           License:   SIL (<a href='http://scripts.sil.org/OFL' target='_blank'>http://scripts.sil.org/OFL</a>)<br />
           Homepage:  <a href='http://fontello.com' target='_blank'>http://fontello.com</a>
   </li>
</ul>

<script>
{{>init-loaderconfig-js}}
{{>loaderconfig-js}}
{{>index-js}}
</script>