注意 ElementPlus 的 Icon 图标 要额外安装插件 @element-plus/icons-vue.
npm install @element-plus/icons-vue
定义一个文件 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])
}
}
main.js 中引入
import { registerElIcon } from './elements-icon.js'
// 全局注册 el-icon
registerElIcon(app);
在组件内局部注册,这里使用 。
<script setup>
import {
Postcard as ElIconPostcard,
Calendar as ElIconCalendar,
} from '@element-plus/icons-vue'
</script>
全局或局部注册的使用方式是一样的。使用方式也有两种,且注意接下来的使用都是加了前缀 el-icon-xxx 或 ElIconXxxx。
< i class=“el-icon-xxx”> 属于 ElementUI 使用方式,在ElementPlus 中无效!
使用 el-icon 为 SVG 图标提供属性
<el-icon :size="size" :color="color">
<el-icon-edit />
el-icon>
<el-icon :size="size" :color="color">
<ElIconEdit />
el-icon>
<el-icon-edit />
<ElIconEdit />
element-ui el-button 中的 icon 使用,属性 icon 是图标类名,类型是 string;element-plus el-button 中的 icon 使用,属性 icon 图标组件,类型是 string /Component;element-ui如图蓝色框是图标,文字标签 包裹图标标签 。
<el-button size="mini" type="text" >
<i class="el-icon-folder-add">i>新建1
el-button>

如图蓝色框是图标,文字标签 与图标标签 同级。
<el-button size="mini" type="text" icon="el-icon-folder-add">
新建2
el-button>

element-plus以下 icon 组件都是加了前缀 ElIconXxxx 和 el-icon-xxx
无论
icon是全局或局部注册,在el-button中的使用方式都是一样的。
SVG 图标如图蓝色框是图标,直接渲染 标签。
<el-button size="small" type="primary" link >
<ElIconFolderAdd/>新建1
el-button>

el-icon 使用如图蓝色框是图标,且被标签 包裹一层。
<el-button size="small" type="primary" link >
<el-icon><ElIconFolderAdd/>el-icon>新建2
el-button>

此处有坑!!!
icon的全局和局部组件注册,在el-button中使用 icon 属性有差异!
局部注册有效,全局注册无效!
el-button 属性 icon;icon 的组件对象;icon 的组件对象,所以渲染失败;html 把文字标签 与标签 渲染为同级;
<el-button size="small" type="primary" link :icon="ElIconFolderAdd">
新建3
el-button>

全局注册有效,局部注册无效!
el-button 属性 icon,且没有 :;ElementUI 方式2 一致了 ;html 把文字标签 与标签 渲染为同级;此方式无效。注意 icon 前没有 : ,传入是 string 类型,组件无法被识别。
<el-button size="small" type="primary" link icon="ElIconFolderAdd">
新建4
el-button>
<el-button size="small" type="primary" link icon="el-icon-folder-add">
新建5
el-button>

element-ui el-input 中的 icon 使用,属性前缀 prefix-icon 或后缀 suffix-icon 是图标类名,类型是 string;
element-plus el-input 中的 icon 使用,属性前缀 prefix-icon 或后缀 suffix-icon 是图标组件,类型是 string /Component;
element-ui有两种方式:
prefix-icon 和后缀 suffix-icon ;slot 方式:使用前缀 prefix 和后缀 suffix ;
<el-input placeholder="请输入内容" prefix-icon="el-icon-search" v-model="inputVal">el-input>
<el-input placeholder="请输入内容" v-model="inputVal">
<i slot="prefix" class="el-input__icon el-icon-search">i>
el-input>
element-plus这里不再赘述 icon 组件的全局注册和局部注册的差异。与 el-button 同理。
同样有两种方式。:
prefix-icon 和后缀 suffix-icon ;slot 方式:使用前缀 #prefix 和后缀 #suffix ;
<el-input placeholder="请输入内容" :prefix-icon="ElIconSearch" v-model="inputVal" />
<el-input placeholder="请输入内容" prefix-icon="ElIconSearch" v-model="inputVal" />
<el-input placeholder="请输入内容" prefix-icon="el-icon-search" v-model="inputVal" />
<el-input placeholder="请输入内容" v-model="inputVal">
<template #prefix>
<el-icon class="el-input__icon"><ElIconSearch/>el-icon>
template>
el-input>
这里不再赘述 icon 组件的全局注册和局部注册的差异。与 el-button 同理。
element-ui el-dropdown 中的 icon 使用,属性 icon 是图标类名,类型是 string;
element-plus el-dropdown 中的 icon 使用,属性 icon 是图标组件,类型是 string /Component;
使用属性 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>
使用属性 icon 方式。
<el-dropdown-menu>
<el-dropdown-item command="admin" :icon="ElIconSetting">后台管理el-dropdown-item>
<el-dropdown-item command="theme" icon="ElIconDataAnalysis">切换主题el-dropdown-item>
<el-dropdown-item command="logout" :con="el-icon-switch-button">注销el-dropdown-item>
el-dropdown-menu>