安装

环境支持

Element Plus 可以在支持 ES2018 安装 - 图1 ResizeObserver 安装 - 图2 的浏览器上运行。 如果您确实需要支持旧版本的浏览器,请自行添加 Babel 安装 - 图3 和相应的 Polyfill 。

由于 Vue 3 不再支持 IE11,Element Plus 也不再支持 IE 浏览器。

安装 - 图4安装 - 图5安装 - 图6安装 - 图7
Edge ≥ 79Firefox ≥ 78Chrome ≥ 64Safari ≥ 12

版本

Element Plus 目前还处于快速开发迭代中。

安装 - 图8

使用包管理器

我们建议您使用包管理器 (NPM, Yarn 安装 - 图9 , pnpm 安装 - 图10 ) 安装 Element Plus, 然后您就可以使用打包工具,例如 Vite 安装 - 图11 webpack 安装 - 图12

  1. # 选择一个你喜欢的包管理器
  2. # NPM
  3. $ npm install element-plus --save
  4. # Yarn
  5. $ yarn add element-plus
  6. # pnpm
  7. $ pnpm install element-plus

如果您的网络环境不好,建议使用相关镜像服务 cnpm 安装 - 图13 中国 NPM 镜像 安装 - 图14

浏览器直接引入

直接通过浏览器的 HTML 标签导入 Element Plus,然后就可以使用全局变量 ElementPlus了。

根据不同的 CDN 提供商有不同的引入方式, 根据不同的 CDN 提供商有不同的引入方式, 我们在这里以 unpkg 安装 - 图15 jsDelivr 安装 - 图16 举例。 你也可以使用其它的 CDN 供应商。

unpkg

  1. <head>
  2. <!-- Import style -->
  3. <link rel="stylesheet" href="//unpkg.com/element-plus/dist/index.css" />
  4. <!-- Import Vue 3 -->
  5. <script src="//unpkg.com/vue@3"></script>
  6. <!-- Import component library -->
  7. <script src="//unpkg.com/element-plus"></script>
  8. </head>

jsDelivr

  1. <head>
  2. <!-- Import style -->
  3. <link
  4. rel="stylesheet"
  5. href="//cdn.jsdelivr.net/npm/element-plus/dist/index.css"
  6. />
  7. <!-- Import Vue 3 -->
  8. <script src="//cdn.jsdelivr.net/npm/vue@3"></script>
  9. <!-- Import component library -->
  10. <script src="//cdn.jsdelivr.net/npm/element-plus"></script>
  11. </head>

TIP

我们建议使用 CDN 引入 Element Plus 的用户在链接地址上锁定版本,以免将来 ElementPlus 升级时受到非兼容性更新的影响。 锁定版本的方法请查看 unpkg.com 安装 - 图17

Hello World

通过 CDN 的方式我们可以很容易地使用 Element Plus 写出一个 Hello world 页面。 在线演示 安装 - 图18

如果是通过包管理器安装,并希望配合打包工具使用,请阅读下一节:快速上手