记一次字体引入,导致的线上问题

319 阅读3分钟

故事背景

公司一位前端同事,开发一个新功能,需要引入字体文件,让UI传入iconfont,当他正准备往项目中引入时,发现项目中存在一个iconfont.js,iconfont-new.js, iconfont.css等文件,他没有多想,直接将iconfont.js, iconfont.css作了文件替换,对iconfont-new.js删除了引用,最后导致线上很多以前的老图标都无法正常显示。

反思

平时对iconfont的引入没有进行深入的学习与思考。于是又专门去查看了官方文档iconfont代码使用 。并在这里再作一次记录,提醒自己。

Web端使用

用户在iconfont.cn可以下载,多种格式的icon, 平台也可将图标转换为字体,便于前端工程师自由调整与调用。

icon 单个使用


单个图标用户可以自行选择下载不同的格式使用,包括pngsvg。 点击下载按钮,可以选择下载图标。 icon

此种方式适合在图标引用特别少,以后也不需要特别维护的场景。

  • 比如设计师用来做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">&#x33;</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>