跳到正文

Element Plus 集成检查 ​

项目定位 ​

Fast.Element.Plus 是正式开源的 Fast 系列业务 SDK,面向 Fast 团队以及认同 Fast 团队编码与交互约定的开发者。它基于 Element Plus 提供约定式默认值、远程数据、表格、上传、弹窗等业务能力,但不承诺可以无差异替代 Element Plus 原生组件。

项目会保留对 Element Plus 默认 Props 和 ElMessageBox.alert、ElMessageBox.confirm、ElMessageBox.prompt 单例方法的团队化增强。这些增强在导入 Fast.Element.Plus 根入口时应用,属于 SDK 运行时契约。

依赖范围 ​

  • Element Plus:^2.14.7
  • Vue:^3.5.11

依赖范围来自当前包配置,不等同于范围内所有版本均已验证。调整依赖时,按下方清单核对运行时行为、公开类型和样式;不要只更新版本和锁文件,也不为旧版本继续维护另一套实现。

2.14.8 核对记录 ​

Fast.Element.Plus 2.0.28 将 Element Plus 最低版本提高到 ^2.14.8。本站交互示例和自动 API 表仍使用已安装的 fast-element-plus@2.0.27。

  • 对照已安装的 Element Plus Props、Emits、Slots 和实例 API,补齐图片预览、选择器、表格、树形选择器、图片上传和车牌输入的透传。
  • FaDrawer 透传 resizable 的 { minSize, maxSize } 配置及 resize-start、resize、resize-end。draggable 控制 Fast 自己的拖拽条,两套交互可分别配置。
  • 选择器使用 Fast 的 data / requestApi 数据入口。 FaSelectPage 仍从 requestApi 获取分页选项。弹窗保留 Fast 的异步 open、close,图片上传组件保留各自的单图、多图模式。

必查内容 ​

对下列封装逐项核对 Element Plus 原生 Props、Emits、Slots 和 Expose:

Fast 组件Element Plus 基础组件
FaAvatarElAvatar
FaButtonElButton
FaDialogElDialog
FaDrawerElDrawer
FaFormElForm
FaImageElImage
FaSelect、FaSelectPageElSelect
FaSelectV2ElSelectV2
FaTable、FaTableColumnElTable、ElTableColumn
FaTreeElTree
FaTreeSelectElTreeSelect
FaUpload、FaUploadImage、FaUploadImagesElUpload

核对要求:

  1. 新增的原生 Prop 是否需要透传、覆盖默认值或明确不支持。
  2. 删除或重命名的原生 Prop 是否仍残留在本仓库手工定义中。
  3. 原生 Emit 的名称、参数和触发时机是否变化;业务事件是否会重复触发。
  4. 原生 Slot 的名称和作用域参数是否变化;封装是否丢失作用域数据。
  5. 原生 Expose 方法是否新增、删除或变更签名。
  6. setPropsDefaults 支持的组件和默认值是否仍有效。
  7. ElMessageBox 快捷方法重载与 beforeClose 行为是否变化。
  8. ElInput 的 clearable 是否在空值时渲染并占用后缀空间。
  9. SCSS 使用的 .el-* 内部结构和 CSS 变量是否变化。
  10. TypeScript 声明、根导出、CDN 构建和 Tree Shaking 是否正常。

建议流程 ​

  1. 阅读目标版本 Changelog 和相关组件文档。
  2. 更新 peerDependencies、devDependencies 和锁文件。
  3. 对照 Element Plus 类型声明,记录新增或缺失的 Props、Emits、Slots 和 Expose。
  4. 人工核对 Slots、Expose、默认值、事件时序和内部样式结构。
  5. 为行为变化增加组件测试,并更新 API、运行时契约和 Changelog。
  6. 执行 pnpm check 和发布包内容检查。
  7. 保持本文的依赖范围与实际配置一致,并单独记录实际完成的检查。

业务封装可以有意改变 Element Plus 默认值、事件语义或交互方式,但必须在公开类型和文档中明确,不得因为依赖升级而无意缺失或保留已经失效的原生能力。