declarative.dpml 1.7 KB

1234567891011121314151617181920212223242526272829303132
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <memory>
  3. <item id="mem_1752633976293_138s3tkn5" time="2025/07/16 10:46">
  4. <content>
  5. Vue3 UniApp项目开发规范总结:
  6. ## 页面类型规范
  7. 1. **系统原生导航栏页面**:使用 layout: &#x27;default&#x27; + 自定义导航栏配置(如income.vue)
  8. 2. **自定义导航栏页面**:使用 navigationStyle: &#x27;custom&#x27; + 手动处理安全区域(如referEarn.vue)
  9. ## 代码书写习惯
  10. 1. **UnoCSS样式**:完全使用UnoCSS原子类,避免传统CSS,优先使用内联样式避免动态类名问题
  11. 2. **组件库**:wot-design-uni (wd-前缀组件),包括wd-form、wd-input、wd-button等
  12. 3. **分页组件**:z-paging统一处理列表和滚动,配合useZPaging hook
  13. 4. **TypeScript**:严格类型定义,defineOptions命名规范
  14. ## 项目结构规范
  15. 1. **路由配置**:使用json5格式的route块,自动生成pages.json
  16. 2. **生命周期**:必须导入页面生命周期(即使未直接使用)
  17. 3. **插件配置**:自定义vite插件处理构建逻辑
  18. 4. **组件结构**:route配置 → script setup → template → style
  19. ## 具体编码规范
  20. 1. **安全区域**:自定义导航栏页面必须处理safeAreaInsets
  21. 2. **组件命名**:defineOptions中明确name属性
  22. 3. **表单处理**:使用wd-form + wd-input + 验证规则
  23. 4. **样式写法**:优先UnoCSS原子类,必要时使用:deep()修改组件样式
  24. 5. **背景图片**:统一使用/static/login-bg.png作为登录相关页面背景
  25. </content>
  26. <tags>#最佳实践</tags>
  27. </item>
  28. </memory>