故事背景
公司一位前端同事,开发一个新功能,需要引入字体文件,让UI传入iconfont,当他正准备往项目中引入时,发现项目中存在一个iconfont.js,iconfont-new.js, iconfont.css等文件,他没有多想,直接将iconfont.js, iconfont.css作了文件替换,对iconfont-new.js删除了引用,最后导致线上很多以前的老图标都无法正常显示。
反思
平时对iconfont的引入没有进行深入的学习与思考。于是又专门去查看了官方文档iconfont代码使用 。并在这里再作一次记录,提醒自己。
Web端使用
用户在iconfont.cn可以下载,多种格式的icon, 平台也可将图标转换为字体,便于前端工程师自由调整与调用。
icon 单个使用
单个图标用户可以自行选择下载不同的格式使用,包括png、svg。
点击下载按钮,可以选择下载图标。
此种方式适合在图标引用特别少,以后也不需要特别维护的场景。
- 比如设计师用来做demo原型。
- 前端临时做个活动页。
- 当然如果你只是为了下载图标做PPT,也是极好的。
不过如果是成体系的应用使用,建议用户把icon加入项目,然后使用下面三种推荐的方式。
unicode引用
unicode是字体在网页端最原始的应用方式,特点是:
- 兼容性最好,支持IE6+,及所有现代浏览器。
- 支持按字体的方式去动态调整图标大小,颜色等等。
- 但是因为是字体,所以不支持多色。只能使用平台里单色的图标,就算项目里有多色图标
注意:新版iconfont支持多色图标,这些多色图标在unicode模式下将不能使用,如果有需求建议使用symbol的引用方式。
unicode使用步骤如下:
第一步:拷贝项目下面生成的font-face
@font-face {font-family: 'iconfont';
src: url('iconfont.eot');
src: url('iconfont.eot?#iefix') format('embedded-opentype'),
url('iconfont.woff') format('woff'),
url('iconfont.ttf') format('truetype'),
url('iconfont.svg#iconfont') format('svg');
}
或者使用在线链接
@font-face {
font-family: "iconfont"; /* Project id 3595869 */
src: url('//at.alicdn.com/t/c/font_3595869_phr6w23ja.woff2?t=1675323599330') format('woff2'),
url('//at.alicdn.com/t/c/font_3595869_phr6w23ja.woff?t=1675323599330') format('woff'),
url('//at.alicdn.com/t/c/font_3595869_phr6w23ja.ttf?t=1675323599330') format('truetype');
}
第二步:定义使用iconfont的样式
.iconfont {
font-family:"iconfont" !important;
font-size:16px;font-style:normal;
-webkit-font-smoothing: antialiased;
-webkit-text-stroke-width: 0.2px;
-moz-osx-font-smoothing: grayscale;
}
第三步:挑选相应图标并获取字体编码,应用于页面
<i class="iconfont">3</i>
font-class 引用
font-class 是unicode使用方式的一种变种,主要是解决unicode书写不直观,语意不明确的问题。
与unicode使用方式相比,具有如下特点:
- 兼容性良好,支持IE8+,及现代浏览器。
- 相比于unicode语意明确,书写更直观。可以很容易分辨这个icon是什么。
- 因为使用class来定义图标,所以要替换图标时,只需要修改class里面的unicode引用。
- 不过因为本质上还是使用字体,所以多色图标还是不支持的。
使用步骤如下: 第一步:拷贝项目下面生成的fontclass代码:
//at.alicdn.com/t/font_8d5l8fzk5b87iudi.css
第二步:挑选相应图标并获取类名,应用于页面:
<i class="iconfont icon-xxx"></i>
symbol引用
这是一个全新的使用方式,应该说这才是未来的主流,也是平台目前推荐的用法。相关介绍可以参考这篇文章 这种用法其实是做了一个svg的集合,与上面两种相比具有如下特点:
- 支持多色图标了,不再受单色限制。
- 通过一些技巧,支持像字体那样,通过
font-size,color来调整样式。 - 兼容性较差,支持IE9+,及现代浏览器。
- 浏览器渲染svg的性能一般,还不如png。
使用步骤如下: 第一步:拷贝项目下面生成的symbol代码:
//at.alicdn.com/t/font_8d5l8fzk5b87iudi.js
第二步:加入通用css代码(引入一次就行)
<style type="text/css">
.icon {
width: 1em;
height: 1em;
vertical-align: -0.15em;
fill: currentColor;
overflow: hidden;
}
</style>
第三步:挑选相应图标并获取类名,应用于页面:
<svg class="icon" aria-hidden="true"> <use xlink:href="#icon-xxx"></use> </svg>