图标库生成器使用手册

字数

888 字

阅读时间

4 分钟

运行环境

node >= 16.15.0

使用步骤

生成

1. 将命名好的svg文件放入根目录的svg文件夹下
2. 如素材来源为iconfont，删除如下xml头

<?xml version="1.0" standalone="no"?><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">

<?xml version="1.0" encoding="utf-8"?>
<!-- Generator: Adobe Illustrator 23.0.2, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->

3. 运行npm run font

自定义：

1. 自定义字体名称: 在.svgtofontrc中设置fontName， 比如cvic-icon
2. 自定义字体大小: 在package.json中设置css.fontSize

4. 查看生成后的font-class.html文件，检查图标生成效果

使用

Unicode 引用

Unicode 是字体在网页端最原始的应用方式，特点是：

• 支持按字体的方式去动态调整图标大小，颜色等等。
• 默认情况下不支持多色，直接添加多色图标会自动去色。

注意：新版 iconfont 支持两种方式引用多色图标：SVG symbol 引用方式和彩色字体图标模式。（使用彩色字体图标需要在「编辑项目」中开启「彩色」选项后并重新生成。）

Unicode 使用步骤如下：

第一步：拷贝项目下面生成的 @font-face

@font-face {
  font-family: 'cvic-icon';
  src: url('cvic-icon.woff2?t=1666776552075') format('woff2'),
       url('cvic-icon.woff?t=1666776552075') format('woff'),
       url('cvic-icon.ttf?t=1666776552075') format('truetype');
}

第二步：定义使用 cvic-icon的样式

.cvic-icon {
  font-family: "iconfont" !important;
  font-size: 16px;
  font-style: normal;
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
}

第三步：挑选相应图标并获取字体编码，应用于页面

<span class="cvic-icon">&#x33;</span>

"cvic-icon" 是你项目下的 font-family。可以通过编辑项目查看，默认是 "cvic-icon"。

font-class 引用

font-class 是 Unicode 使用方式的一种变种，主要是解决 Unicode 书写不直观，语意不明确的问题。

与 Unicode 使用方式相比，具有如下特点：

• 相比于 Unicode 语意明确，书写更直观。可以很容易分辨这个 icon 是什么。
• 因为使用 class 来定义图标，所以当要替换图标时，只需要修改 class 里面的 Unicode 引用。

使用步骤如下：

第一步：引入项目下面生成的 fontclass 代码：

<link rel="stylesheet" href="./cvic-icon.css">

第二步：挑选相应图标并获取类名，应用于页面：

<span class="cvic-icon-xxx"></span>

" cvic-icon" 是你项目下的 font-family。可以通过编辑项目查看，默认是 "cvic-icon"。

Symbol 引用

这是一种全新的使用方式，应该说这才是未来的主流，也是平台目前推荐的用法。相关介绍可以参考这篇文章

这种用法其实是做了一个 SVG 的集合，与另外两种相比具有如下特点：

• 支持多色图标了，不再受单色限制。
• 通过一些技巧，支持像字体那样，通过 font-size, color 来调整样式。
• 兼容性较差，支持 IE9+，及现代浏览器。
• 浏览器渲染 SVG 的性能一般，还不如 png。

使用步骤如下：

第一步：引入项目下面生成的 symbol 代码：

<script src="./cvic-icon.js"></script>

第二步：加入通用 CSS 代码（引入一次就行）：

<style>
.cvic-icon {
  width: 1em;
  height: 1em;
  vertical-align: -0.15em;
  fill: currentColor;
  overflow: hidden;
}
</style>

第三步：挑选相应图标并获取类名，应用于页面：

<svg class="cvic-icon" aria-hidden="true">
  <use xlink:href="#cvic-icon-xxx"></use>
</svg>

贡献者

Ryan.G

页面历史

最后编辑于 大约 1 个月前

查看完整历史

3f23e5d-chore(content): init