1. 字体图标与矢量图标
目前主要有两种图标类型:字体图标和矢量图标。
字体图标是在网页打开时,下载一整个图标库,通常可以通过特定标签例如 <i>
来使用,优点是方便地实现文字混排,缺点是包体积大,且难以自定义。
矢量图标本质是 <svg>
标签,包中只含有所需的图标,且很容易自定义,也可以选用不同图标库来源的图标,甚至可以用自定义 SVG,缺点是与文字混排相对复杂。
本文推荐并主要使用矢量图标。
2. 矢量图标源
目前比较全面的图标集:
-
Google Material Symbols (之前的 Google Icon):比较现代化的图标集,包括圆角尖角图标集、 空心实心图标集,主打交互图标,没有商标。
-
Material Design Icons:Material 风格的另一个图标集,大而全。
-
Iconfont:阿里的图标库,包括很多带颜色的特殊图标
-
Iconify:一个各种图标集的收集站,我们后文使用的包可以使用其中的所有图标集。
以上基本可以满足任何使用要求了。
3. 安装图标包及其剪枝策略
为了在 Vue 中便捷地使用图标,可以使用 iconify-prerendered 库,包含了所有 iconify 中图标集的图标的组件:
# 安装 Material Symbols 包
npm i @iconify-prerendered/vue-material-symbols
# 安装 Material Design Icons 包
npm i @iconify-prerendered/vue-mdi
当需要引入时,可以使用:
<script setup lang="ts">
import { IconWarningRounded } from '@iconify-prerendered/vue-material-symbols';
</script>
<template>
<IconWarningRounded />
</template>
@iconify-prerendered/vue-material-symbols
的图标一般命名格式为:
Icon + 图标名 + 可选: Outline (空心) + 可选: Rounded (圆角)
同时,这里我们需要引入各个所需的图标,而不能使用通配符:
# 不能这样
import * from '@iconify-prerendered/vue-mdi';
这是因为我们的代码需要剪枝友好。剪枝是一种代码编译策略,毕竟不可能将包中所有的图标都发往客户端浏览器,所以编译为 js 包时,只会包含已经被 import 的图标,因此最大程度地减少了包体积。
注意:当 vite 运行在 dev 模式时,iconify-prerendered
会将整个图标包 (10M) 发送到浏览器,而不会剪枝,因此首次加载会很慢,请耐心等待。build 后会自动剪枝,不会再出现这种情况。
4. 图标与文字混排
由于我们使用的图标包本质上会将图标以 <svg>
标签的形式渲染,因此需要考虑混排的问题,一般用 flex
容器先包含两个元素,然后在 icon 上使用 my-auto
以实现:
<script setup lang="ts">
import { IconWarningRounded } from '@iconify-prerendered/vue-material-symbols';
</script>
<template>
<div class="flex text-red-700 gap-2">
<IconWarningRounded class="my-auto w-6 h-6" />
<p class="text-lg font-semibold">Error!</p>
</div>
</template>
5. 自定义 SVG 图标
自定义 SVG 图标一般需要关注:viewBox
(代表定义的画布范围)、fill
(颜色)两个属性:
<template>
<svg viewBox="0 0 16 16" fill="currentColor">
<path
d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"
/>
</svg>
</template>
这个 SVG 可以由 Adobe Illustrator 生成 (另存为 SVG),略微修改即可做成 Vue 组件使用。
如果需要修改图标颜色,可以直接设置 color
属性:
<script setup lang="ts">
import { IconWarningRounded } from '@iconify-prerendered/vue-material-symbols';
</script>
<template>
<IconWarningRounded class="text-red-500" />
</template>
如果需要分别设定各个路径,可以直接在 <path>
上进行修改,例如使用 fill 属性修改填充颜色:
<template>
<svg viewBox="0 0 16 16">
<path class="fill-slate-400 hover:fill-slate-300 transition-colors duration-300"
d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"
/>
<path class="fill-red-400 hover:fill-yellow-300 transition-colors duration-300"
d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"
/>
</svg>
</template>
6. 案例分析
上述方式已经使用在开源项目 GithubStar.Pro 中,你可以进入网站体验。该项目的源码在:Github,提供了一个 Vue 3.0 + Tailwind CSS + Iconify-Prerendered 的使用案例。
也欢迎各位使用 GithubStar.Pro 互赞平台,提高您的开源项目知名度,收获更多用户。