编辑 | blame | 历史 | 原始文档

组件和图标基础 | Art Design Pro

本文档介绍 Art Design Pro 中组件库和图标的使用方法。

Element Plus 组件库

项目使用 Element Plus 作为基础 UI 组件库,覆盖了 80% 的常用组件需求。

自动导入配置

项目通过 unplugin-vue-components 实现组件按需自动导入:

// vite.config.js
Components({
  resolvers: [
    ElementPlusResolver(),
  ],
  dts: 'src/types/import/components.d.ts'
})

可用组件

Element Plus 提供:
- 基础组件:按钮、表单、表格等
- 反馈组件:弹窗、消息提示等
- 布局组件:容器、栅格系统等

官方文档:https://element-plus.org/

样式定制

样式文件路径:src/assets/styles/el-ui.scss

@forward 'element-plus/theme-chalk/src/common/var.scss' with (
  $colors: (
    'primary': (
      'base': #409EFF,
    ),
  ),
);

系统内置组件

图标相关

  • 图标选择器 - 可视化图标选择工具

媒体处理

  • 图像裁剪 - 图片上传和裁剪组件
  • 视频播放器 - 视频播放组件

数据处理

  • Excel 导入导出 - 数据导入导出功能
  • 数字滚动 - 统计数字动画

编辑器

  • 富文本编辑器 - 基于 wangEditor

特效组件

  • 水印 - 页面水印组件
  • 右键菜单 - 自定义右键菜单
  • 文字滚动 - 文字滚动效果
  • 礼花效果 - 节日特效

其他

  • 二维码 - 二维码生成器
  • 拖拽 - 拖拽排序功能

图标系统

项目内置 600+ 图标,满足大部分图标需求。

图标库目录

图标资源目录:src/assets/icons/system

使用方式

Unicode 方式

<i class="iconfont-sys">&#xe649;</i>

Font class 方式

<i class="iconfont-sys iconsys-gou"></i>

图标扩展

如需添加自定义图标,可访问系统图标库进行扩展。

注意:系统图标使用 iconfont-sys 类名,而非 iconfont,方便用户扩展。

系统模板

卡片模板

  • 统计卡片
  • 数据展示卡片
  • 图表卡片

横幅模板

  • 基础横幅
  • 卡片横幅

图表模板

  • 柱状图
  • 折线图
  • 饼图
  • 雷达图
  • 地图图表

其他模板

  • 地图页面
  • 聊天页面
  • 日历页面
  • 定价页面

最佳实践

  1. 优先使用系统组件 - 系统组件已经过优化和测试
  2. 参考官方文档 - Element Plus 官方文档提供完整 API
  3. 统一样式 - 保持整个项目的视觉一致性
  4. 按需导入 - 使用自动导入减少打包体积

相关文档