Back to Prompt Optimizer

组件标准化重构

docs/archives/107-component-standardization/README.md

2.10.22.2 KB
Original Source

组件标准化重构

📋 功能概述

将项目中所有模态框/弹窗类组件的行为和API统一,使其完全符合"最佳实践范式",提高代码一致性、可维护性和开发者体验。

🎯 目标

  • 统一所有模态框组件的prop为modelValue
  • 为所有模态框添加Escape键支持
  • 建立统一的组件API规范
  • 提高代码一致性和可维护性

📅 时间线

  • 开始时间: 2025-07-01
  • 当前状态: 🔄 进行中
  • 预计完成: 2025-07-15

🎯 涉及组件

组件目标PropEscape键支持状态
FullscreenDialog.vuemodelValue✅ 已支持最佳范式
Modal.vuemodelValue待实现v-model已规范
DataManager.vuemodelValue✅ 已支持Esc键已规范
HistoryDrawer.vuemodelValue✅ 已支持Esc键已规范
ModelManager.vuemodelValue待实现需要改进
TemplateManager.vuemodelValue待实现需要改进

📋 任务清单

1. 标准化Prop为 modelValue

  • DataManager.vue
  • HistoryDrawer.vue
  • ModelManager.vue
  • TemplateManager.vue
  • App.vue: 更新所有对上述组件的调用,将 v-model:show="..." 修改为 v-model="..."

2. 补全 Escape 键支持

  • ModelManager.vue
  • TemplateManager.vue
  • Modal.vue (基础组件)

3. 后续重构与优化

  • 修复 ModelManager.vue 弹窗问题 (高优先级)
  • 解决 TypeScript 类型错误 (中优先级)
  • 修复 CSS 兼容性问题 (低优先级)
  • 统一模态框(Modal)组件实现 (长期)

📚 相关文档

🔗 关联功能


状态: 🔄 进行中
负责人: AI Assistant
最后更新: 2025-07-01