ng-antd-admin

✨前言

• 我作为angular的粉丝，想以本项目作为我为angular社区尽一点力所能及之力，希望大家喜欢这个模板，也希望更多的国内开发者能重新审视angular这一前端框架，特别是ng17以后的版本，我相信angular会越来越好，我也会一直维护下去，如果您有什么好的建议，可以加我的微信号hj345678912，我拉你进交流群，一起学习进步交流（平时群里说话人不多）。

✨项目介绍

• 本项目也有一点点教学性质，其中用到大量angular新特性，有详细的注释以及参考文章链接在代码中，大家可以看看源码，有问题与我讨论，有改进处可以提pr，我们一起进步
• 在线预览地址 这里为了节省服务器费用，这个预览地址是基于ng18的纯静态网站，所有数据采用mswjs作为mock，如果你只想简单本地启动前端看看效果，可以下载这里的代码，直接npm安装好依赖就可以启动，源码这里，
• 我也提供了剔除掉所有第三方包以及所有业务，仅保留框架基本结构的纯净版，你可以基于纯净版对接你自己的后端服务，项目地址 pure，
  
• 如果您用我的项目进行学习或者参考，请先确定您使用的是angular哪个版本，因为angular15后写法有部分不一样，所以我的建议是，您正在使用angular什么版本，则下载对应版本的ng-antd-admin,最新版本直接从master分支下载即可，历史版本在这个链接进行下载这里。
  

✨关于前端

• 支持最新angular版本
• Support the latest angular version
• 所有组件onPush,性能卓越
• All components onPush, excellent performance
• 代码示例丰富，有完整服务端后台，前后端分离示例
• Rich code examples, complete server background, front-end and back-end separation examples
• 常用工具类，服务， 指令，管道，封装了表格，抽屉，对话框等常用功能
• Common tools, services, instructions, pipelines。Encapsulates common functions such as tables, drawers, and dialog boxes
• 全部组件均为独立组件，文件量减少（如果需要module版本，请看这里）
• Standalone Components（module style is here）
• 已开启zoneless

✨关于后端

• 采用nestjs,drizzle,postgresql,以rbac为权限模型，集成了jwt,添加了接口权限，功能权限。完成用户管理，菜单管理，部门管理，角色管理等模块。开箱即用

✨特性

• 支持最新angular版本
• Support the latest angular version
• 所有组件onPush,性能卓越
• All components onPush, excellent performance
• 代码示例丰富，有完整服务端后台，前后端分离示例
• Rich code examples, complete server background, front-end and back-end separation examples
• 常用工具类，服务， 指令，管道，封装了表格，抽屉，对话框等常用功能
• Common tools, services, instructions, pipelines。Encapsulates common functions such as tables, drawers, and dialog boxes
• 全部组件均为独立组件，文件量减少（如果需要module版本，请看这里）
• Standalone Components（module style is here）

✨以前录制的使用教程

• 快速二开使用详解 快速二开使用详解
  
• 项目搭建简易教程 项目搭建简易教程
  

✨如何启动

1. 如果你只想看看前端，启动起来看看效果，直接拉取源码这里，这个ng18的纯前端版本，
   直接npm install，npm run star查看效果。

2. 如果你想启动nodejs端，

3. 需要本地安装好docker。

4. 进入nest-api目录下

5. 在命令行运行命令"docker-compose up -d"，用以安装postgresql镜像以及容器，

6. 启动docker中的容器新拉的postgresql容器，

7. 你可能需要一款数据库连接工具，例如用DataGrip,Navicat等工具连接docker中的postgres数据库。用户名“admin”，密码“123456”，数据库名称“ng-antd-admin-db”

8. 执行nest-api目录下的ng-antd-admin-db.sql这个sql

9. 在nest-api目录下npm install ,执行npm run start.在ui目录下执行npm install ,以及npm run start

✨前端的一些配置项

路由的key(routing key)

key需要设置成路由地址最后一个'/'后的字符串，并且要所有路由中唯一
The key needs to be set to the string after the last '/' of the routing address, and it must be unique

const routes: Routes = [
  {path: '', data: {key: 'login', shouldDetach: 'no'}, component: LoginFormComponent}
];

组件不需要保存状态，(Modules don't need to save state)

保存状态的意思是，类似于vue的keep-alive，在angular中称为路由复用，组件的状态会保留，不会由于切换页签而丢失状态，默认都是开启的，如果不需要这个功能，则配置shouldDetach: 'no'

const routes: Routes = [
  {path: '', data: {key: 'login', shouldDetach: 'no'}, component: LoginFormComponent}
];

组件在保存状态下的生命周期(The temporary statement cycle of switching tab calls is as follows)

组件在保存状态下(即“路由复用”)的情况下切换页签，onInit,onOndestroy会失效(因为组件被缓存了，没有重新创建或者销毁)，我们提供了临时声明周期如下，可以在进入页面，或者离开页面时被触发 直接在目标组件中写出方法名为_onReuseInit或者_onReuseDestroy的方法即可实现，你可以全局搜这两个方法的名字，看示例
It can be realized by directly writing the method named _onReuseInit or _onReuseDestroy in the target component

_onReuseInit: () => void;
_onReuseDestroy: () => void;

栅格系统监听(grid system monitoring)

enum EquipmentWidth {
  xs,  // (max-width: 575.98px)
  sm,  // (min-width: 576px) and (max-width: 767.98px)
  md,  // (min-width: 768px) and (max-width: 991.98px)
  lg,  // (min-width: 992px) and (max-width: 1199.98px)
  xl,  // (min-width: 1200px) and (max-width: 1599.98px)
  xxl  // (min-width: 1600px)
}

使用方式(How to use)

  constructor(private windowsWidthService: WindowsWidthService) {
  }
  
  this.windowsWidthService.getWindowWidthStore().pipe(takeUntil(this.destory$)).subscribe(res => {
    this.currentEquipmentWidth = res;
    this.cdr.markForCheck();
  })

组件不要预加载(Modules do not need to be preloaded)

如果模块不需要预加载则添加以下配置，默认都是开启的

export const routes: Routes = [
  {
    path: 'contact',
    loadChildren: import(() => './contact/contact.module').then(m => m.ContactModule),
    data: {
      preload: false
    }
  }
];

模块中打开新tab页来展示详情，必须设置参数如下(Open a new tab page in the module to display the details, and the parameters must be set as follows)

在data中设置，这个场景请看在线地址上的演示，菜单为：功能>标签页操作>打开详情页1、打开详情页2、打开详情页3

const routes: Routes = [
  {path: '', component: TabsComponent, data: {title: '标签页操作', key: 'tabs'}},
  {path: 'example-detail', component: DetailComponent, data: {newTab:'true', title: '演示详情', key: 'example-detail'}}
];

在当前页签中打开详情

在data中设置title需要是同样的，这样就可以在当前页签中打开详情，这个场景请看在线地址上的演示，菜单为：系统管理>角色管理>设置权限

export default [
  {
    path: '',
    component: RoleManageComponent,
    title: '角色管理',
    data: { key: 'role-manage' }
  },
  {
    path: 'set-role',
    component: SetRoleComponent,
    title: '角色管理',
    data: {
      key: 'set-role',
      authCode: ActionCode.RoleManagerSetRole
    }
  }
] satisfies Route[];

缓存页面中指定容器的滚动条(The scroll bar of the specified container in the cache page)

在data中设置scrollContain 为元素选择器 (Set scrollContain as element selector in data)，这个场景请看在线地址上的演示，菜单为：功能>滚动条>缓存滚动条

  {path: '', component: KeepScrollPageComponent, data: {title: '缓存滚动条', key: 'keep-scroll-page',scrollContain:['#div-scroll1','#div-scroll2']}}

系统截图(System screenshot)

star支持

怎么说呢，所以如果本项目对您有用，如果您也愿意的话，麻烦帮忙点个star，谢谢啊

if help you, if you want ,please give me a star ,thank you

另外

如果项目需要定制，或者有好的远程项目，兼职，外包等，也可以与我联系。不限前后端，移动端技术栈。希望可以出卖点体力赚取点收入

捐赠

如果本项目对您有用，正巧您如果也想请我喝一杯咖啡，请扫下面的码，哈哈。在此感谢您
If this project is useful to you, and you happen to want to invite me for a cup of coffee, please scan Alipay or WeChat

🏴授权协议License

MIT