naeasy-ui-prefer-components.mdc 1.4 KB

12345678910111213141516171819202122
  1. ---
  2. description: 编写界面优先使用 NaEasy UI(src/components)组件
  3. globs: "**/*.vue"
  4. alwaysApply: false
  5. ---
  6. # NaEasy UI 优先(`src/components`)
  7. 依据 `src/components/README.md`:**NaEasy UI** 为本项目内置的 UniApp 移动端组件库;编写、改版界面时应**优先使用仓库内 `src/components` 下的组件与封装**,再考虑手写原生标签或其它 UI 包。
  8. ## 实践要点
  9. - **导入路径**:本项目 TypeScript 配置为 `@/*` → `src/*`,请使用 **`@/components/...`** 引用(与 README 中「组件库」源码目录一致;勿与 `@/` 以外臆测别名混淆)。
  10. - **文档**:官方说明见 [NaEasy UI UniApp 文档](https://docs.imengyu.top/naeasy-ui-uniapp-docs/);复杂 props、行为以文档与现有页面用法为准。
  11. - **选型顺序**:同类需求若有 NaEasy 封装(含 `form`、`layout`、`dynamic` 等子目录)→ 先用封装;确无对应能力时再组合底层组件或扩展,并在改动处保持与现有风格一致(间距、字段、`Field`/`Form` 等)。
  12. - **许可与归属**:组件库为 MIT;商用与标注要求见 README「版权说明」「使用注意事项」。
  13. ## 避免
  14. - 在未确认目录内是否已有组件的情况下,新增与其它页面不一致的第三方 UI 依赖。
  15. - 绕过已有表单体系重复造复杂表单(可结合项目内 `DynamicForm` 等既有模式)。