bulma/docs/documentation/elements/icon.html
2017-08-14 13:01:07 +01:00

102 lines
2.7 KiB
HTML

---
title: Icon
layout: documentation
doc-tab: elements
doc-subtab: icon
variables:
- name: $icon-dimensions
value: 1.5rem
- name: $icon-dimensions-small
value: 1rem
- name: $icon-dimensions-medium
value: 2rem
- name: $icon-dimensions-large
value: 3rem
---
{% capture icon_example %}
<span class="icon">
<i class="fa fa-home"></i>
</span>
{% endcapture %}
{% include subnav-elements.html %}
<section class="section">
<div class="container">
<h1 class="title">Icons</h1>
<h2 class="subtitle">
Bulma is compatible with <strong><a href="http://fortawesome.github.io/Font-Awesome/">Font Awesome</a></strong> icons.
</h2>
{%
include meta.html
colors=false
sizes=true
variables=true
%}
<hr>
<div class="content">
<p>Because the icons can take a few seconds to load, and because you want control over the <strong>space</strong> the icons will take, you can use the <code>icon</code> class as a container:</p>
</div>
<div class="bd-example">
{{icon_example}}
</div>
{% highlight html %}{{icon_example}}{% endhighlight %}
<div class="content">
<p>The <code>icon</code> container will take up <em>exactly</em> <strong>1.5rem x 1.5rem</strong>. The icon itself is sized at <strong>21px</strong>.</p>
</div>
{% include heading.html name="Sizes" %}
<div class="content">
<p>Font Awesome icons use a font-size of <strong>28px</strong> by default, and are best rendered when using <strong>multiples of 7</strong>.</p>
<p>The Bulma <code>icon</code> container is always slightly bigger than the font-size used:</p>
</div>
<table class="table">
<thead>
<tr>
<th colspan="2">Class</th>
<th>Font-size</th>
<th>Container size</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>icon is-small</code></td>
<td><span class="icon is-small"><i class="fa fa-home"></i></span></td>
<td>14px</td>
<td>1rem x 1rem</td>
</tr>
<tr>
<td><code>icon</code></td>
<td><span class="icon"><i class="fa fa-home"></i></span></td>
<td>21px</td>
<td>1.5rem x 1.5rem</td>
</tr>
<tr>
<td><code>icon is-medium</code></td>
<td><span class="icon is-medium"><i class="fa fa-home"></i></span></td>
<td>28px</td>
<td>2rem x 2rem</td>
</tr>
<tr>
<td><code>icon is-large</code></td>
<td><span class="icon is-large"><i class="fa fa-home"></i></span></td>
<td>42px</td>
<td>3rem x 3rem</td>
</tr>
</tbody>
</table>
{% include variables.html %}
</div>
</section>