本项目为 vdesign-ui
前端组件库,包含组件源码、构建脚本、设计 Tokens、多语言配置等。以下是项目目录结构与主要文件说明。
vdesign-ui/
├── bin/ # 构建与工具脚本目录
│ ├── backup-token-css.js # 备份 token.css 文件(保存至 dist-token-history,文件名带时间戳)
│ ├── build-components.js # 构建 packages/components 下的组件并输出到 dist/components,按需加载,暂未用到
│ ├── concat-css.js # 合并 tokens 中多个 CSS 文件为 token.css
│ ├── copy-locales.js # 拷贝 packages/locale 的内容到 dist/locale
│ └── node.js # 输出官网导航目录
├── dist/ # 构建输出目录
│ ├── components/ # 拷贝组件
│ ├── locale/ # 拷贝语言资源
│ ├── demo.html # 构建预览页面(可能用于调试或预览组件)
│ ├── token.css # 当前 Design Token 输出样式
│ ├── vdesign-ui.common.js # CommonJS 格式构建文件
│ ├── vdesign-ui.css # 所有样式文件合并后的主 CSS
│ ├── vdesign-ui.umd.js # UMD 构建文件(未压缩)
│ ├── vdesign-ui.umd.min.js # UMD 构建文件(压缩版)
│ └── dist-token-history/ # 历史 Token 样式备份(时间戳命名)
│ ├── token_20250314_155751.css
│ ├── token_20250314_160005.css
│ ├── token_20250314_160803.css
│ ├── token_20250321_171830.css
│ ├── token_20250324_152753.css
│ ├── token_20250324_153128.css
│ ├── token_20250325_114906.css
│ └── token_20250326_170122.css
├── node_modules/ # 项目依赖模块
├── packages/ # 源码主目录
│ ├── components/ # Vue 组件源码(Button、Uploader 等)
│ ├── locale/ # 多语言支持
│ │ ├── lang/ # 多语言翻译文件(如 zh-CN.js / en-US.js)
│ │ └── i18nPlugin.js # 国际化插件封装(用于 Vue 插件注册)
│ └── tokens/ # Design Token 配置(设计样式原子值)
│ ├── css/ # 生成后的 CSS Token 文件
│ ├── fonts/ # 字体资源
│ ├── js/ # 获取以及生成Token数据
│ ├── index.css # 主样式文件
│ ├── reset.css # 样式重置文件
│ └── style.css # 组件通用样式
│ └──index.js # 项目主入口(可能用于组件库导出)
├── sites/ # 主要包含该组件库的站点,用于文档描述
│ ├── assets/ # 静态资源(如图片、图标)
│ ├── components/ # 站点使用的公共组件
│ ├── demos/ # 组件演示页面(提供交互效果展示)
│ ├── docs/ # 文档页面(介绍使用说明、API 参考等)
│ ├── i18n/ # 站点的国际化支持
│ ├── json/ # json格式的Token数据
│ ├── pages/ # 站点页面路由(测试页面)
│ ├── router/ # Vue 路由配置
│ ├── App.vue # 站点 Vue 入口文件
│ ├── insetTables.js # Token数据插入到demo页面
│ └── main.js # 站点主入口文件