ui-guidelines.mdc 1.2 KB

123456789101112131415161718192021222324252627282930313233
  1. ---
  2. description: UI/UX 指南、样式规范和组件使用
  3. globs: **/*.vue, **/*.scss, src/components/**/*, src/uni_modules/**/*, uno.config.ts
  4. alwaysApply: false
  5. ---
  6. # UI 与样式指南
  7. ## 🎨 样式系统
  8. - **引擎**: UnoCSS (原子化 CSS) 是**首选**的样式方案。
  9. - **配置**: `uno.config.ts`。
  10. - **预处理**: SCSS 用于复杂的组件样式(极少需要)。
  11. - **主题**: 通过 `src/theme.json` 和 CSS 变量支持亮色/暗色模式切换。
  12. ### UnoCSS 约定
  13. - 使用工具类: `flex`, `items-center`, `text-primary`, `m-4`.
  14. - 响应式前缀: `sm:`, `md:` (在移动端优先的 uni-app 中较少使用)。
  15. - 图标: 通过 UnoCSS preset 使用 `i-carbon-{icon-name}`。
  16. ## 🧩 组件库
  17. - **核心库**: `wot-design-uni` (`wd-` 前缀)。
  18. - **文档**: [wot-design-uni](https://wot-ui.cn).
  19. - **自定义组件**: 在 `src/components` 中创建。
  20. ## 📢 全局反馈
  21. - **Toast/Message**: 请勿直接使用 `uni.showToast`。
  22. - **标准**: 使用 `GlobalToast`, `GlobalMessage`, `GlobalLoading` 组件。
  23. - **Skill**: 参考 **`global-feedback`** skill 查看使用示例。
  24. ## 📱 布局
  25. - **系统**: `vite-plugin-uni-layouts`。
  26. - **默认**: `src/layouts/default.vue`。
  27. - **TabBar**: `src/layouts/tabbar.vue`。