示例

几种常用写法

引入之后,用 <i> 把图标放到页面上。 部分示例来自 Bootstrap 文档。

下面的例子按 Font Awesome CDN 来写,CDN 会自动补无障碍属性。不用 CDN 的话,看 手动写法,以及 无障碍说明。

Example: basic icon fa-camera-retro

类名用前缀 fa 加上图标名。放在行内元素上。 <i> 更短,<span> 语义更合适。

<i class="fa fa-camera-retro"></i> fa-camera-retro
  • 示例 容器的字号变大,图标也会变大。颜色、阴影,以及能继承的 CSS 属性都一样。

fa-lg

fa-2x

fa-3x

fa-4x

fa-5x

相对容器放大:fa-lg(大约大 33%)、fa-2x、 fa-3x、fa-4x、fa-5x。

<i class="fa fa-camera-retro fa-lg"></i> fa-lg
<i class="fa fa-camera-retro fa-2x"></i> fa-2x
<i class="fa fa-camera-retro fa-3x"></i> fa-3x
<i class="fa fa-camera-retro fa-4x"></i> fa-4x
<i class="fa fa-camera-retro fa-5x"></i> fa-5x
  • 图标上下被切掉时,把 line-height 加大。

fa-fw 把图标收成一样宽,列表和导航里才对齐。

<div class="list-group">
  <a class="list-group-item" href="#"><i class="fa fa-home fa-fw" aria-hidden="true"></i>&nbsp; 首页</a>
  <a class="list-group-item" href="#"><i class="fa fa-book fa-fw" aria-hidden="true"></i>&nbsp; 资料库</a>
  <a class="list-group-item" href="#"><i class="fa fa-pencil fa-fw" aria-hidden="true"></i>&nbsp; 应用</a>
  <a class="list-group-item" href="#"><i class="fa fa-cog fa-fw" aria-hidden="true"></i>&nbsp; 设置</a>
</div>
  • 列表图标
  • 可以当作
  • 项目符号
  • 用在列表里

用 fa-ul 和 fa-li 替换无序列表的圆点。

<ul class="fa-ul">
  <li><i class="fa-li fa fa-check-square"></i>列表图标</li>
  <li><i class="fa-li fa fa-check-square"></i>可以当作</li>
  <li><i class="fa-li fa fa-spinner fa-spin"></i>项目符号</li>
  <li><i class="fa-li fa fa-square"></i>用在列表里</li>
</ul>

…明天我们会跑得更快,把手臂张得更开…然后在某个晴朗的早晨— 于是我们继续奋力向前,逆着水流的小船,不停地被推回过去。

fa-border 加边框,fa-pull-right 或 fa-pull-left 让图标绕排。

<i class="fa fa-quote-left fa-3x fa-pull-left fa-border" aria-hidden="true"></i>
...明天我们会跑得更快,把手臂张得更开...
然后在某个晴朗的早晨&mdash;于是我们继续奋力向前,逆着水流的小船,
不停地被推回过去。

正在加载(fa-spinner) 正在加载(fa-circle-o-notch) 正在加载(fa-refresh) 正在加载(fa-cog) 正在加载(fa-spinner)

fa-spin 连续旋转,fa-pulse 分 8 步转。 常和 fa-spinner、fa-refresh、fa-cog 一起用。

<i class="fa fa-spinner fa-spin fa-3x fa-fw"></i>
<span class="sr-only">Loading...</span>
<i class="fa fa-circle-o-notch fa-spin fa-3x fa-fw"></i>
<span class="sr-only">Loading...</span>
<i class="fa fa-refresh fa-spin fa-3x fa-fw"></i>
<span class="sr-only">Loading...</span>
<i class="fa fa-cog fa-spin fa-3x fa-fw"></i>
<span class="sr-only">Loading...</span>
<i class="fa fa-spinner fa-pulse fa-3x fa-fw"></i>
<span class="sr-only">Loading...</span>

注意: 有的浏览器会让动画图标发抖。例子和绕法见 issue #671。

注意: IE8 和 IE9 不支持 CSS3 动画。

  normal
  fa-rotate-90
  fa-rotate-180
  fa-rotate-270
  fa-flip-horizontal
  fa-flip-vertical

旋转、翻转用 fa-rotate-* 和 fa-flip-*。

<i class="fa fa-shield"></i> normal<br>
<i class="fa fa-shield fa-rotate-90"></i> fa-rotate-90<br>
<i class="fa fa-shield fa-rotate-180"></i> fa-rotate-180<br>
<i class="fa fa-shield fa-rotate-270"></i> fa-rotate-270<br>
<i class="fa fa-shield fa-flip-horizontal"></i> fa-flip-horizontal<br>
<i class="fa fa-shield fa-flip-vertical"></i> fa-flip-vertical
fa-twitter on fa-square-o
fa-flag on fa-circle
fa-terminal on fa-square
fa-ban on fa-camera

父元素加 fa-stack,小图标加 fa-stack-1x, 大图标加 fa-stack-2x。fa-inverse 用来反色。 父元素还可以加 更大图标 的类名来控制整体大小。

<span class="fa-stack fa-lg">
  <i class="fa fa-square-o fa-stack-2x"></i>
  <i class="fa fa-twitter fa-stack-1x"></i>
</span>
fa-twitter on fa-square-o<br>
<span class="fa-stack fa-lg">
  <i class="fa fa-circle fa-stack-2x"></i>
  <i class="fa fa-flag fa-stack-1x fa-inverse"></i>
</span>
fa-flag on fa-circle<br>
<span class="fa-stack fa-lg">
  <i class="fa fa-square fa-stack-2x"></i>
  <i class="fa fa-terminal fa-stack-1x fa-inverse"></i>
</span>
fa-terminal on fa-square<br>
<span class="fa-stack fa-lg">
  <i class="fa fa-camera fa-stack-1x"></i>
  <i class="fa fa-ban fa-stack-2x text-danger"></i>
</span>
fa-ban on fa-camera

Font Awesome 可以直接用在 Bootstrap 组件上。

<a class="btn btn-danger" href="#">
  <i class="fa fa-trash-o fa-lg"></i> 删除</a>
<a class="btn btn-default btn-sm" href="#">
  <i class="fa fa-cog"></i> 设置</a>
<a class="btn btn-lg btn-success" href="#">
  <i class="fa fa-flag fa-2x pull-left"></i> Font Awesome<br>Version 4.7.0</a>
<div class="btn-group">
  <a class="btn btn-default" href="#">
    <i class="fa fa-align-left" title="Align Left"></i>
  </a>
  <a class="btn btn-default" href="#">
    <i class="fa fa-align-center" title="Align Center"></i>
  </a>
  <a class="btn btn-default" href="#">
    <i class="fa fa-align-right" title="Align Right"></i>
  </a>
  <a class="btn btn-default" href="#">
    <i class="fa fa-align-justify" title="Align Justify"></i>
  </a>
</div>
<div class="input-group margin-bottom-sm">
  <span class="input-group-addon"><i class="fa fa-envelope-o fa-fw"></i></span>
  <input class="form-control" type="text" placeholder="邮箱">
</div>
<div class="input-group">
  <span class="input-group-addon"><i class="fa fa-key fa-fw"></i></span>
  <input class="form-control" type="password" placeholder="密码">
</div>
<div class="btn-group open">
  <a class="btn btn-primary" href="#"><i class="fa fa-user fa-fw"></i> User</a>
  <a class="btn btn-primary dropdown-toggle" data-toggle="dropdown" href="#">
    <span class="fa fa-caret-down" title="Toggle dropdown menu"></span>
  </a>
  <ul class="dropdown-menu">
    <li><a href="#"><i class="fa fa-pencil fa-fw"></i> Edit</a></li>
    <li><a href="#"><i class="fa fa-trash-o fa-fw"></i> 删除</a></li>
    <li><a href="#"><i class="fa fa-ban fa-fw"></i> 禁止</a></li>
    <li class="divider"></li>
    <li><a href="#"><i class="fa fa-unlock"></i> 设为管理员</a></li>
  </ul>
</div>

字体能用 CSS 做的,图标也能做。

星级评分(来自 CSS Tricks)

正在刷新... 正在保存...

电量:50%

按 无障碍说明:图标只是装饰时,读屏不用念出来。图标本身表达意思时,要把同样的文字交给辅助技术。

<a class="btn btn-default" href="path/to/settings" aria-label="设置">
  <i class="fa fa-cog" aria-hidden="true"></i>
</a>
<a class="btn btn-danger" href="path/to/settings" aria-label="删除">
  <i class="fa fa-trash-o" aria-hidden="true"></i>
</a>
<a class="btn btn-primary" href="#navigation-main" aria-label="跳到主导航">
  <i class="fa fa-bars" aria-hidden="true"></i>
</a>
<i class="fa fa-refresh fa-spin fa-3x fa-fw" aria-hidden="true"></i>
<span class="sr-only">正在刷新...</span>
<i class="fa fa-cog fa-spin fa-3x fa-fw" aria-hidden="true"></i>
<span class="sr-only">正在保存...</span>
<div class="input-group margin-bottom-sm">
  <span class="input-group-addon"><i class="fa fa-envelope-o fa-fw" aria-hidden="true"></i></span>
  <input class="form-control" type="text" placeholder="邮箱">
</div>
<div class="input-group">
  <span class="input-group-addon"><i class="fa fa-key fa-fw" aria-hidden="true"></i></span>
  <input class="form-control" type="password" placeholder="密码">
</div>
<a href="path/to/shopping/cart" class="btn btn-primary" aria-label="查看购物车里的 3 件商品">
  <i class="fa fa-shopping-cart" aria-hidden="true"></i>
</a>
<i class="fa fa-battery-half" aria-hidden="true"></i>
<span class="sr-only">电量:50%</span>