Vue组件封装之阿里图标库

如果文中有错别字、错误内容或者有缺点之处，麻烦在评论区进行评论，望与诸君共同进步，在此共勉。

前言

平时在项目中经常需要用到一些精致而小巧的 icon，这些 icon 对于不是美工出身的我是很难进行自制，但是我们可以引用第三方的 icon。这里推荐使用 阿里巴巴矢量库

引用阿里矢量库中 icon 的方法有很多种

• 直接下载到本地
• 引用线上 svg 格式

如果你只需要引用单个第三方icon，使用以上方法即可。

如果你想要为你的项目引用一套icon，建议使用下面的方法

一、阿里图标仓库的使用

进入官网并注册账号，寻找合适的icon，将鼠标移动到icon上

点击购物车，将其添加到购物车上，点击右上角的购物车图标即可查看我们已添加到购物车中的内容

当我们选完项目中需要使用的icon时，点击购物车 => 添加至项目 => 对项目进行命名 => 确定

随即就会跳转到 “我的项目” 界面，这里存放我们添加过的图标项目（可以点击图标管理 => 我的项目到达此页面）

这里有三种引用方法，后续有介绍

• Unicode
• Font class
• Symbol

我们将鼠标悬停在图标上面可以选择进行添加入库、编辑图标、删除图标、下载图标、复制代码等操作

接下来介绍三种引用方式的方法

二、三种引用方式

2.1. 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');
}

第二步：定义使用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>

2.2. font-class引用

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

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

• 兼容性良好，支持ie8+，及所有现代浏览器。
• 相比于unicode语意明确，书写更直观。可以很容易分辨这个icon是什么。
• 因为使用class来定义图标，所以当要替换图标时，只需要修改class里面的unicode引用。
• 不过因为本质上还是使用的字体，所以多色图标还是不支持的。

使用步骤如下：

第一步：拷贝项目下面生成的fontclass代码：

将其引入项目中

 @import "//at.alicdn.com/t/font_8d5l8fzk5b87iudi.css"

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

<i class="iconfont icon-xxx"></i>

2.3. symbol引用

这是一种全新的使用方式，应该说这才是未来的主流，也是平台目前推荐的用法。相关介绍可以参考这篇文章 这种用法其实是做了一个svg的集合，与上面两种相比具有如下特点：

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

使用步骤如下：

第一步：拷贝项目下面生成的symbol代码：

<script src="http://at.alicdn.com/t/font_8d5l8fzk5b87iudi.js"></script>

第二步：加入通用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>

三、封装阿里图标组件

上面的三种引用方式我们使用 symbol 引用来封装组件。

我习惯将能在其余项目中单独引用的组件放在 /components/common 中，所以组件路径为 /components/common/AliIcon.vue

3.1. 封装步骤

步骤一：创建一个 AliIcon.vue ，封装阿里图标

• 功能：使用 icon 来引用图标，必填；使用 size 来控制图标大小，默认单位px；使用 color 来控制图标颜色
• 注意：style 标签不能携带 scoped 属性，携带这个属性就不会将样式应用到全局

<template>
<svg class="icon" aria-hidden="true" :color="color" :font-size="fontSize">
  <use :xlink:href="getIcon"></use>
  </svg>
</template>

<script>
  export default {
    name: "AliIcon",
    computed: {
      getIcon() {
        return '#' + this.icon
      }
    },
    props: {
      icon: {
        type: String,
        required: true
      },
      fontSize: {
        type: String
      },
      color: {
        type: String
      }
    }
  }
</script>

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

步骤二：将阿里项目中的symbol代码在 index.html 中进行引用

<script src="//at.alicdn.com/t/font_8d5l8fzk5b87iudi.js"></script>

步骤三：将组件注册成全局组件（main.js）

// main.js
import AliIcon from './components/content/AliIcon/AliIcon'
Vue.component('ali-icon',AliIcon)

组件就这样封装完成啦！之后我们就可以在项目中使用阿里图标库中我们选中的图标啦。

做一个小测试：

<template>
  <div>
    <ali-icon icon="icon-home" color="red" size="3em"/>
  </div>
</template>

<script>
  export default {
    name: "test",
    components: {}
  }
</script>

<style scoped>
</style>

测试结果：

3.2. 注意事项

• 如果你在阿里图标库中新添加了一个图标，原本的 JS 路径将需要进行更新，将新的代码放在 index.html 中即可（旧的路径还可以使用，只是无法使用新添加的图标）

• 带有颜色的图标无法修改其 color 属性，修改后无效

• 如果修改了 size 属性，图标大小没有发生变化，可能是你没有引入公共 CSS

  .icon {
    width: 1em; height: 1em;
    vertical-align: -0.15em;
    fill: currentColor;
    overflow: hidden;
  }
  

• 如果对引用线上 JS 文件不感冒，可以将代码下载下来然后在本地进行引用
  

资料引用：https://www.iconfont.cn/help/detail?spm=a313x.7781069.1998910419.16&helptype=code