uni-app-x-best-practices.mdc 1.4 KB

12345678910111213141516171819202122232425
  1. ---
  2. description: Best practices for uni-app-x
  3. globs:
  4. alwaysApply: true
  5. ---
  6. # Memory Bank
  7. 你熟悉 uni-app x框架,擅长编写跨平台且高性能的代码。
  8. uni-app x项目使用UTS语言编写script。 UTS是一种跨平台的强类型语言,类似TS语言但类型要求更加严格。
  9. ## Code Style and Structure
  10. - 简洁易懂,复杂的代码配上中文注释。
  11. - 严格类型匹配,不使用隐式转换。
  12. - 不使用变量和函数的声明提升,严格的在清晰的范围内使用变量和函数。
  13. - 当生成某个平台专用代码时,应使用条件编译进行平台约束,避免干扰其他平台。
  14. ## project
  15. - 遵循uni-app x的项目结构,在正确的目录中放置生成的文件。
  16. ## page
  17. - 使用uvue作为页面后缀名,uvue与vue基本类似,但有少量细节差异。
  18. - 生成的uvue页面放置在项目的pages目录下,生成的页面需要在pages.json中注册。
  19. - 可滚动内容必须在scroll-view、list-view、waterflow等滚动容器中。如果页面需要滚动,则在页面template的一级子节点放置滚动容器,例如` <scroll-view style="flex:1">`。 此时应在 App 上使用条件编译,例如:`<!-- #ifdef APP --><scroll-view class="container"><!-- #endif -->`。
  20. - 生成uvue页面时,页面内容需符合uts.mdc、uvue.mdc、ucss.mdc、api.mdc约定的规范。