框架提供一系列的组件方便快速开发。
基础组件由 Element Plus 提供,其中包含按钮、文字链接、单选框、多选框、输入框、计数器、级联选择器、开关、滑块等 50+ 个组件。
阅读并学习请查看 Element Plus 官方文档。
说明
为了统一图标的使用,框架没有采用 Element Plus 官方图标的使用方式,这意味着部分 Element Plus 组件的 icon 属性将无法使用,例如 Button 按钮组件。
<!-- 无法使用 -->
<el-button icon="el-icon-edit">编辑</el-button>
<!-- 可以使用插槽代替 -->
<el-button>
<template #icon>
<el-icon>
<svg-icon name="ep:edit" />
</el-icon>
</template>
编辑
</el-button>
如果你习惯 Element Plus 官方图标的使用方式,需执行 pnpm install @element-plus/icons-vue
安装依赖,并按照官方的使用方式引入图标,点击查看详细介绍。
替换组件库
如果你不喜欢 Element Plus ,或者你想要将老项目迁移到 One-step-admin 上,但老项目里使用的组件库并不是 Element Plus ,框架也提供了组件库替换移方案:
如果你想使用的组件库不在上述方案中,可以通过参考任何一份方案,理解替换的整理思路,并自行替换,别担心会很复杂,我们已经将大部分工作做好了。
为了实现 UI 组件库可替换,框架内建了一些组件,这些组件仅服务于框架自身,所以不建议在业务页面内使用。但如果你需要对框架进行二次开发,并保证视觉上的一致性,这时候你就会需要用到它们。
内建组件存放在 /src/layouts/ui-kit/
目录下,并配置了使用时自动引入。
扩展组件为框架封装的组件,有全新开发的组件,也有在 Element Plus 组件上二次封装的组件,还有一些则是封装了第三方的插件。
组件源码完全开放,如果觉得用着不顺手,可以到 /src/components/
目录下找到对应组件自行修改。