引入之后,用 <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
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
fa-fw 把图标收成一样宽,列表和导航里才对齐。
<div class="list-group">
<a class="list-group-item" href="#"><i class="fa fa-home fa-fw" aria-hidden="true"></i> 首页</a>
<a class="list-group-item" href="#"><i class="fa fa-book fa-fw" aria-hidden="true"></i> 资料库</a>
<a class="list-group-item" href="#"><i class="fa fa-pencil fa-fw" aria-hidden="true"></i> 应用</a>
<a class="list-group-item" href="#"><i class="fa fa-cog fa-fw" aria-hidden="true"></i> 设置</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>
...明天我们会跑得更快,把手臂张得更开...
然后在某个晴朗的早晨—于是我们继续奋力向前,逆着水流的小船,
不停地被推回过去。
正在加载(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-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)
按 无障碍说明:图标只是装饰时,读屏不用念出来。图标本身表达意思时,要把同样的文字交给辅助技术。
<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>