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