开始使用

把 Font Awesome 4.7.0 加到网站上

用 CDN 只要一行代码,不用下载、不用安装。

每个网站用自己的嵌入地址,升级时不用改页面代码。这需要一个邮箱,用来区分并找回你的嵌入地址。

直接用在页面上

不用自己管字体文件。675 个图标和 CSS 一起从 CDN 加载。

升级省事

换 CDN 地址上的版本号,就能用上新版本。

自动补上无障碍属性

CDN 可以按无障碍的写法自动处理图标。做法见 无障碍。

异步加载

图标可以放到后面加载,页面先出来。

或

想自己托管文件?可以 下载 压缩包,里面有图标和默认样式,CSS、Sass、Less 都有。

用 CSS

  1. 把整个 font-awesome 目录拷进项目。
  2. 在页面的 <head> 里引用 font-awesome.min.css。
    <link rel="stylesheet" href="path/to/font-awesome/css/font-awesome.min.css">
    
  3. 接着看 示例。

用 Sass 或 Less

要用 Less 或 Sass 改 Font Awesome 4.7.0,按下面做。

  1. 把 font-awesome/ 目录拷进项目。
  2. 打开项目里的 font-awesome/less/variables.less 或 font-awesome/scss/_variables.scss,把 @fa-font-path 或 $fa-font-path 改成你的字体目录。
    @fa-font-path:   "../font";
    

    这个路径相对的是编译出来的 CSS 所在目录。

  3. 如果用静态编译,重新编译一次 Less 或 Sass。
  4. 接着看 示例。
或

Less Ruby Gem

用 Font Awesome Less Ruby Gem 把 Less 加进 Rails 项目。由 @supercodepoet 维护。

  1. 在 Gemfile 里加上这一行:
    gem 'font-awesome-less'
    
  2. 然后执行:
    $ bundle
    
  3. 或者自己安装:
    $ gem install font-awesome-less
    

如果用 Rails,把下面两行加到 application.less:

@import "font-awesome-sprockets";
@import "font-awesome";

Sass Ruby Gem

用 Font Awesome Sass Ruby Gem 把 Sass 加进 Rails 或 Compass。由 @supercodepoet 维护。

  1. 在 Gemfile 里加上这一行:
    gem 'font-awesome-sass'
    
  2. 然后执行:
    $ bundle
    
  3. 或者自己安装:
    $ gem install font-awesome-sass
    

如果用 Rails,把下面两行加到 application.scss:

@import "font-awesome-sprockets";
@import "font-awesome";

校验器

为了照顾有问题的旧浏览器,Font Awesome 在几处用了 CSS 浏览器 hack。校验器会把这些写法报成无效。还有几处用了当时还没完全标准化的 CSS,只作为渐进增强。

这些警告不影响使用:正常的那部分 CSS 能通过校验,hack 也不会妨碍它。

入门说明中的校验器,作者 Bootstrap 团队,许可 CC BY 3.0

Internet Explorer 8 和 @font-face

IE8 在 @font-face 和 :before 一起用时有问题。 Font Awesome 正好用了这个组合。页面被缓存后,如果鼠标不在窗口上就刷新,或在 iframe 里打开,字体会晚于页面画出来。 鼠标移到页面上,一部分图标才出现;再移到剩下的图标上,那些也会出现。 细节见 issue #954。

入门说明中的 Internet Explorer 8 和 @font-face,作者 Bootstrap 团队,许可 CC BY 3.0

需要支持 IE7?

4.7.0 不支持 IE7,3.2.1 支持。请看 3.2.1 的 IE7 说明。

排查问题

图标没出来的话,先看 排查维基。 由 @gtagliala 维护。