Element Plus 的 el-icon 到底怎么用?

一起养成写作习惯!这是我参与「掘金日新计划 · 4 月更文挑战」的第1天,点击查看活动详情

本文简介

点赞 + 关注 + 收藏 = 学会了


Vue 生态里, Element UI 是排名前列的组件库。 在 Vue 发布到 3.0 时,Element 也发布了对应的组件库。也就是 Element Plus 。随之而来的用法也跟着变了。

比如本文要讲的 el-icon 的用法。


Element Plus 里,Icon 图标 的用法和以前不一样了。虽然官方文档也有说明怎么用,但不是非常详细,可能会给新手带来一丢丢障碍。

本文将花几分钟的时间讲解 el-icon 几种用法和注意事项。

注意:需要留意本文发表时间与使用的 Element Plus 版本,随着时间的推移可能会出现使用上的差异。

vue: ^3.2.25

element-plus: ^2.1.7

@element-plus/icons-vue: ^1.1.4



初步了解

Icon 在 Element UI 和 Element Plus 用法上的差别

vue2 + Element UI 的用法

<i class="el-icon-edit"></i>


vue3 + Element Plus 的用法

<ElIcon :size="30" color="hotpink">
  <edit />
</ElIcon>

<!-- 也可以直接使用图标标签,无需父标签包裹 -->
<edit />


个人觉得,Element UI 的用法会更加简单。

下一篇文章我会讲解如何在 Element Plus 的基础上二次封装出一个更好用的 Icon组件


Icon 在 Element Plus 中的使用逻辑

Element Plus 抛弃了字体图标的用法,直接使用了 svg 的方式。

可以说,图标这个东西被拎出来单独维护了。所以在使用前必须把 svg图标库 下载下来。

下载 svg图标库 的命令:

npm install @element-plus/icons-vue

你也可以使用 Yarnpnpm 的方式下载

# Yarn
yarn add @element-plus/icons-vue


# pnpm
pnpm install @element-plus/icons-vue


使用的方式有2种,一种是直接使用 svg,另一种是配合 el-icon 标签一起使用。

接下来就分别讲讲这两种使用方式(全局和局部引入都会讲到)



只使用 svg

如果你只需使用 Element Plus 提供的 svg图标库 的话,是可以不安装 Element Plus 的。不过这种场景应该很少出现。

安装命令:

npm install @element-plus/icons-vue


Element Plus 提供的 svg图标 种类可以到 图标集合 里查看。


通过 svg组件 的方式使用图标,如需设置图标大小和颜色,都需要通过 css 来设置。


全局引入

全部引入的方式会将所有 svg组件 都注册到全局,用的时候比较方便,但会牺牲一点性能。

main.js

import { createApp } from 'vue'
import App from './App.vue'
import * as Icons from '@element-plus/icons-vue' // 引入所有图标,并命名为 Icons

const app = createApp(App)

// 通过遍历的方式注册所有 svg组件,会牺牲一点点性能
for (let i in Icons) {
  app.component(i, Icons[i])
}

app.mount('#app')


如果你不想全部引入,只是想在全局注册某个 svg图标组件,可以用以下方式在 main.js 里注册(我以 Edit 图标为例)

/* 省略部分代码 */
import { Edit } from '@element-plus/icons-vue' // 引入 Edit 图标

const app = createApp(App)

app.component(Edit.name, Edit) // 全局注册 Edit 图标

app.mount('#app')


在页面中使用

<template>
  <div>
    <edit />
  </div>
</template>

<style>
svg {
  width: 40px;
  height: 40px;
  color: red;
}
</style>
file


局部引入

局部引入的方式只需在使用的地方引入即可。

<template>
  <div>
    <edit />
  </div>
</template>

<script setup>
import { Edit } from '@element-plus/icons-vue' // 引入 Edit 这个 svg组件
</script>

<style>
svg {
  width: 40px;
  height: 40px;
  color: red;
}
</style>



配合 el-icon 一起使用

Element Plus 还提供了 el-icon 组件用来包裹 svg图标组件 ,使得设置图标大小和颜色更加方便。

但需要在项目中安装 Element Plus ,安装命令如下:

# 选择其中一种方式安装即可。

# NPM
npm install element-plus --save

# Yarn
yarn add element-plus

# pnpm
pnpm install element-plus


安装完 Element Plus 后,可以在全局引入,也可以局部引入。


全局引入

main.js

import { createApp } from 'vue'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
import { Edit } from '@element-plus/icons-vue' // 引入 Edit 图标
import App from './App.vue'

const app = createApp(App)
app.component(Edit.name, Edit) // 全局注册 Edit 图标

app
.use(ElementPlus)
.mount('#app')


在页面中使用

<el-icon :size="20" color="hotpink">
  <edit />
</el-icon>
file

此时,在 el-icon 上设置 sizecolor 就能控制 svg图标 的大小和颜色。

需要注意的是 size 属性必须传数字,不能传字符串进去!


局部引入

<template>
  <div>
    <el-icon :size="30" color="hotpink">
      <edit />
    </el-icon>
  </div>
</template>

<script setup>
import { ElIcon } from 'element-plus'
import { Edit } from '@element-plus/icons-vue'
import 'element-plus/es/components/icon/style/css'
</script>

局部引入的话,我们只需要引入 icon 对应的 css 即可。

如果你在 main.js 引入了 element-plus/dist/index.css 就不需要在页面再引入 element-plus/es/components/icon/style/css



推荐阅读

👍《Vite 搭建 Vue2 项目(Vue2 + vue-router + vuex)》

👍《Vue3 过10种组件通讯方式》

👍《这18个网站能让你的页面背景炫酷起来》




点赞 + 关注 + 收藏 = 学会了

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,539评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,911评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,337评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,723评论 1 290
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,795评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,762评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,742评论 3 416
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,508评论 0 271
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,954评论 1 308
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,247评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,404评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,104评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,736评论 3 324
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,352评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,557评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,371评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,292评论 2 352

推荐阅读更多精彩内容