首页/软件开发/前端开发/Perigon-Angular前端框架Skill/
名称: perigon-angular
描述: 适用于Perigon WebApp的Angular 21+ 独立组件/Material/信号约定
何时使用
- 在src/ClientApp/WebApp中进行前端开发(组件、路由、服务、样式、国际化)。
使用指南
- 布局结构:入口为main.ts;应用配置在app/app.config.ts;路由在app/app.routes.ts;布局外壳在app/layout/;页面位于app/pages/;共享UI组件在app/share/components;管道在app/share/pipe;守卫在app/share/auth.guard.ts。
- 组件规范:仅使用独立组件;避免使用NgModule。使用Angular Material;主题配置在styles.scss/theme.scss/vars.scss;页面样式保存在各自的*.scss文件中。
- 状态/表单:优先使用信号和信号表单;当信号足够时避免使用传统的双向绑定。
- 服务/API:HTTP客户端和类型定义位于app/services(admin-client、base.service、models/services);保持customer-http.interceptor激活;遵循proxy.conf.json配置;使用environments/environment*.ts管理端点/配置。
- 国际化:字符串资源位于assets/i18n/*.json;键名需与app/share/i18n-keys.ts和scripts/i18n-keys.js保持一致。
- 用户体验/认证:复用布局/导航组件;通过auth.service + auth.guard进行认证;分页器国际化在share/custom-paginator-intl.ts中配置。
- 工具链:使用pnpm;除非请求否则避免构建/测试。保持ESLint/tsconfig默认配置;优先使用独立的Material导入而非已弃用的模块。