Skip to content

API Proxy Tool — UI 设计与交互规范

本文档规范项目的 UI 设计语言与交互行为,是前端开发与设计协作的依据。

设计系统

设计语言

  • 风格: Ant Design Design Language
  • 品牌色: Ant Design 默认色板 + 自定义扩展配色
  • 字体: 系统字体栈(-apple-system, BlinkMacSystemFont, Segoe UI, sans-serif)

组件规范

组件规范状态
ButtonAnt Design Button,主操作使用 type="primary"进行中
FormAnt Design Form + 表单校验进行中
TableAnt Design Table,分页、筛选、排序进行中
ModalAnt Design Modal,确认/取消进行中
TagAnt Design Tag,状态标记进行中
InputAnt Design Input + Search进行中

布局

  • 栅格系统: Ant Design 24 列栅格
  • 断点: Ant Design 标准断点(xs/sm/md/lg/xl/xxl)
  • 间距: Ant Design 间距尺度(4px 基准)

交互模式

页面交互

  • Popup 面板: 点击扩展图标弹出,快速查看和管理当前代理状态
  • Options 页面: 新标签页打开完整配置界面,支持模块管理、规则编辑
  • 模块管理: 卡片列表形式展示模块,支持展开/折叠查看规则
  • 搜索过滤: 实时搜索过滤 API 规则列表
  • 批量操作: 支持批量启用/禁用模块和规则

交互动效

  • 过渡: Ant Design 默认过渡动画(300ms ease)
  • 反馈: Ant Design 加载态(Spin)、空态(Empty)、错误提示(message/notification)
  • 状态切换: 开关切换配有即时视觉反馈

无障碍

  • 所有交互元素支持键盘导航
  • 图片和图标提供合适的 alt 文本 / aria-label
  • 表单输入关联 label 元素

主题定制

  • 亮色主题: Ant Design 默认亮色主题
  • 暗色主题: 未实现(计划中)
  • 主题切换: 未实现

维护说明: 设计团队维护此文档,每次 UI 迭代或设计系统变更时同步更新。

基于 MIT 协议开源