《ElementPlus 与 ElementUI 差异集合》icon 图标使用（包含：el-button，el-input和el-dropdown 差异对比）_el-dropdown 使用icon

安装

注意 ElementPlus 的 Icon 图标 要额外安装插件 @element-plus/icons-vue.

npm install @element-plus/icons-vue
1

注册

全局注册

定义一个文件 element-icon.js ，注意代码第 6 行。加上了前缀 ElIcon ，避免组件命名重复，且易于理解为 element-plus 的 icon。

import * as ElementPlusIconsVue from '@element-plus/icons-vue'

export const registerElIcon = (app) => {
    // 全局注册图标 ElIconXxxx
    for (let i in ElementPlusIconsVue) {
        let name = `ElIcon${i}`;
        app.component(name, ElementPlusIconsVue[i])
    }
}
1
2
3
4
5
6
7
8
9

main.js 中引入

import { registerElIcon } from './elements-icon.js'

// 全局注册 el-icon
registerElIcon(app);
1
2
3
4

局部注册

在组件内局部注册，这里使用 <script setup>。

<script setup>
import {
    Postcard as ElIconPostcard,
    Calendar as ElIconCalendar,
} from '@element-plus/icons-vue'
</script>
1
2
3
4
5
6

基础用法

全局或局部注册的使用方式是一样的。使用方式也有两种，且注意接下来的使用都是加了前缀 el-icon-xxx 或 ElIconXxxx。

< i class=“el-icon-xxx”> 属于 ElementUI 使用方式，在ElementPlus 中无效！

方式一：结合 el-icon 使用

使用 el-icon 为 SVG 图标提供属性

<!-- 小驼峰方式 -->
<el-icon :size="size" :color="color">
	<el-icon-edit />
</el-icon>

<!-- 大驼峰方式 -->
<el-icon :size="size" :color="color">
	<ElIconEdit />
</el-icon>
1
2
3
4
5
6
7
8
9

方式二：直接使用 SVG 图标

<!-- 小驼峰方式 -->
<el-icon-edit />

<!-- 大驼峰方式 -->
<ElIconEdit />
1
2
3
4
5

与 ElementUI 的区别

el-button

• element-ui el-button 中的 icon 使用，属性 icon 是图标类名，类型是 string；
• element-plus el-button 中的 icon 使用，属性 icon 图标组件，类型是 string /Component；

element-ui

方式 1：class=“el-icon-xxx” 类名

如图蓝色框是图标，文字标签 <span> 包裹图标标签 <i class="el-icon-xxx">。

<el-button size="mini" type="text" >
    <i class="el-icon-folder-add"></i>新建1
</el-button>
1
2
3

方式 2：el-button icon 属性

如图蓝色框是图标，文字标签 <span> 与图标标签 <i class="el-icon-xxx">同级。

<el-button size="mini" type="text" icon="el-icon-folder-add">
    新建2
</el-button>
1
2
3

element-plus

以下 icon 组件都是加了前缀 ElIconXxxx 和 el-icon-xxx

1. icon 组件方式

无论 icon 是全局或局部注册，在 el-button 中的使用方式都是一样的。

方式 1：直接使用 SVG 图标

如图蓝色框是图标，直接渲染 <svg> 标签。

<!-- 方式1：直接使用 SVG 图 -->
<el-button size="small" type="primary" link >
	<ElIconFolderAdd/>新建1
</el-button>
1
2
3
4

方式 2：结合 el-icon 使用

如图蓝色框是图标，且被标签 <i class="el-icon"> 包裹一层。

<!-- 方式2：结合 `el-icon` 使用 -->
<el-button size="small" type="primary" link >
	<el-icon><ElIconFolderAdd/></el-icon>新建2
</el-button>
1
2
3
4

2.el-button icon 属性方式

此处有坑！！！ icon 的全局和局部组件注册，在 el-button 中使用 icon 属性有差异！

方式 1：el-button 属性 icon 为 Component 类型

局部注册有效，全局注册无效！

• 使用 el-button 属性 icon；
• 局部注册，在可以找到属性 icon 的组件对象；
• 全局注册，无法找到icon 的组件对象，所以渲染失败；
• html 把文字标签 <span> 与标签 <i class="el-icon"> 渲染为同级；

<!-- 局部注册，注意 icon 前有 : -->
<el-button size="small" type="primary" link :icon="ElIconFolderAdd">
	新建3
</el-button>
1
2
3
4

方式 2：el-button 属性 icon 为 string 类型

全局注册有效，局部注册无效！

• 使用 el-button 属性 icon，且没有 :；
• 全局注册，识别为全局注册的组件名称；
• 局部注册，找不到组件名称，所以渲染失败；
• **小技巧：**代码第 6 行，也可写成小驼峰。这样就和 ElementUI 方式2 一致了 ；
• html 把文字标签 <span> 与标签 <i class="el-icon"> 渲染为同级；

此方式无效。注意 icon 前没有 : ，传入是 string 类型，组件无法被识别。

<!-- 全局注册：注意 icon 前没有 : -->
<el-button size="small" type="primary" link icon="ElIconFolderAdd">
	新建4
</el-button>
<!-- 全局注册：注意 icon 前没有 : -->
<el-button size="small" type="primary" link icon="el-icon-folder-add">
    新建5
</el-button>
1
2
3
4
5
6
7
8

el-input

• element-ui el-input 中的 icon 使用，属性前缀 prefix-icon 或后缀 suffix-icon 是图标类名，类型是 string；

• element-plus el-input 中的 icon 使用，属性前缀 prefix-icon 或后缀 suffix-icon 是图标组件，类型是 string /Component；

element-ui

有两种方式：

1. 属性方式：使用前缀 prefix-icon 和后缀 suffix-icon ；
2. slot 方式：使用前缀 prefix 和后缀 suffix ；

<!-- 属性方式 -->
<el-input placeholder="请输入内容" prefix-icon="el-icon-search" v-model="inputVal"></el-input>  

<!-- slot 方式 -->
<el-input placeholder="请输入内容" v-model="inputVal">
    <i slot="prefix" class="el-input__icon el-icon-search"></i>
</el-input>
1
2
3
4
5
6
7

element-plus

这里不再赘述 icon 组件的全局注册和局部注册的差异。与 el-button 同理。

同样有两种方式。：

1. 属性方式：使用前缀 prefix-icon 和后缀 suffix-icon ；
2. slot 方式：使用前缀 #prefix 和后缀 #suffix ；

<!-- 属性方式，且局部注册，类型为 Component，有 :  -->
<el-input placeholder="请输入内容" :prefix-icon="ElIconSearch" v-model="inputVal" />

<!-- 属性方式，全局部注册，类型为 string。没有 :  -->
<el-input placeholder="请输入内容" prefix-icon="ElIconSearch" v-model="inputVal" />

<!-- 属性方式，全局部注册，类型为 string。没有 : 小驼峰  -->
<el-input placeholder="请输入内容" prefix-icon="el-icon-search" v-model="inputVal" />

<!-- slot 方式 -->
<el-input placeholder="请输入内容" v-model="inputVal">
	<template #prefix>
        <el-icon class="el-input__icon"><ElIconSearch/></el-icon>
	</template>
</el-input>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

el-dropdown

这里不再赘述 icon 组件的全局注册和局部注册的差异。与 el-button 同理。

• element-ui el-dropdown 中的 icon 使用，属性 icon 是图标类名，类型是 string；

• element-plus el-dropdown 中的 icon 使用，属性 icon 是图标组件，类型是 string /Component；

element-ui

使用属性 icon 方式。

<el-dropdown-menu>
    <el-dropdown-item command="about"  icon="el-icon-setting">关于</el-dropdown-item>
    <el-dropdown-item command="theme"  icon="el-icon-data-analysis">主题</el-dropdown-item>
    <el-dropdown-item command="logout" icon="el-icon-switch-button">注销</el-dropdown-item>
</el-dropdown-menu>
1
2
3
4
5

element-plus

使用属性 icon 方式。

<el-dropdown-menu>
    <!-- 属性方式，且局部注册，类型为 Component，有 :  -->
    <el-dropdown-item command="admin" :icon="ElIconSetting">后台管理</el-dropdown-item>
    <!-- 属性方式，全局部注册，类型为 string。没有 :  -->
    <el-dropdown-item command="theme" icon="ElIconDataAnalysis">切换主题</el-dropdown-item>
    <!-- 属性方式，全局部注册，类型为 string。没有 : 小驼峰  -->
    <el-dropdown-item command="logout" :con="el-icon-switch-button">注销</el-dropdown-item>
</el-dropdown-menu>
1
2
3
4
5
6
7
8