Angular是一个非常流行的JavaScript框架，并且随着功能增加，代码量也在不断增加。因此，为了提高代码复用性和减少代码量，有许多优秀的第三方库和工具出现，其中ngalain是其中一个强大的Angular工具集。

一、ngalain的组成部分

ngalain是一个由多个模块组成的工具集。它包含了许多常用的Angular组件、样式和工具函数，可以帮助Angular开发人员提高开发效率，在开发中更加轻松。

ngalain中最常用的组件包括：

• 确认对话框（ConfirmDialog）：用于在用户删除或执行其他敏感操作之前显示一个确认对话框。
• 消息框（Message）：用于在用户执行某些操作后显示消息。
• 模态框（Modal）：用于显示自定义内容的模态框。
• 分页（Pagination）：用于将长列表分解为一页一页的内容。
• 查询表单（SearchForm）：用于帮助用户构建复杂的查询表单。
  此外，ngalain还包含许多有用的样式和工具函数，例如日期处理函数等。

二、ngalain的基本用法

为了使用ngalain，首先需要将其导入到你的项目中。可以使用以下命令将ngalain安装到你的项目中：

npm install ng-alain --save

安装完成后，你可以在你的应用程序中导入它：

import { NgZorroAntdModule } from 'ng-zorro-antd';
import { AlainThemeModule } from '@delon/theme';
import { AlainConfigModule } from '@delon/config';
import { AlainABCModule } from '@delon/abc';

@NgModule({
  imports: [
    BrowserModule,
    FormsModule,
    HttpClientModule,
    BrowserAnimationsModule,
    NgZorroAntdModule,
    AlainThemeModule.forRoot(),
    AlainConfigModule.forRoot(),
    AlainABCModule.forRoot(),
    RouterModule.forRoot(routes, { useHash: true })
  ],
  providers: [
    { provide: APP_INITIALIZER, useFactory: StartupServiceFactory, deps: [StartupService], multi: true }
  ],
  declarations: [
    AppComponent,
    LayoutDefaultComponent,
    LayoutFullScreenComponent,
    HeaderComponent,
    SidebarComponent,
    OfflineComponent,
    SettingDrawerComponent,
    UserComponent,
    FooterComponent
  ],
  bootstrap: [AppComponent]
})
export class AppModule { }

完成导入后，你就可以在你的项目中使用ngalain中的组件和工具了。

三、ngalain的组件详解

1.确认对话框（ConfirmDialog）
确认对话框常用于在用户执行删除、下架或其他敏感操作前给出确认提示。它可以显示自定义的消息内容和按钮文本，并提供点击确定和取消两个回调函数。

import { Component } from '@angular/core';
import { NzModalService } from 'ng-zorro-antd';
import { ConfirmDialogComponent } from '@delon/theme';

@Component({
  selector: 'app-my-component',
  templateUrl: './my.component.html'
})
export class MyComponent {
  constructor(private modalService: NzModalService) {}

  showConfirm(): void {
    const modal = this.modalService.create({
      nzTitle: '确认删除',
      nzContent: '您确定要删除这个条目吗？',
      nzOkText: '删除',
      nzOkType: 'danger',
      nzOnOk: () => console.log('OK'),
      nzCancelText: '取消',
      nzOnCancel: () => console.log('Cancel')
    });
    modal.afterClose.subscribe(result => console.log(result));
  }
}

2.消息框（Message）
消息框可以在用户执行某些操作后显示消息。它可以显示自定义的消息内容和样式，并且可以设置显示时间和关闭回调函数。

import { Component } from '@angular/core';
import { NzMessageService } from 'ng-zorro-antd';
import { MessageComponent } from '@delon/theme';

@Component({
  selector: 'app-my-component',
  templateUrl: './my.component.html'
})
export class MyComponent {
  constructor(private message: NzMessageService) {}

  showMessage(): void {
    this.message.create('success', '保存成功');
  }
}

3.模态框（Modal）
模态框用于显示自定义内容的模态框。它可以显示自定义的标题、内容和按钮，并提供点击确定和取消两个回调函数。

import { Component } from '@angular/core';
import { NzModalService } from 'ng-zorro-antd';
import { ModalComponent } from '@delon/theme';

@Component({
  selector: 'app-my-component',
  templateUrl: './my.component.html'
})
export class MyComponent {
  constructor(private modalService: NzModalService) {}

  showModal(): void {
    const modal = this.modalService.create({
      nzTitle: '模态框',
      nzContent: ModalComponent,
      nzComponentParams: {
        name: 'Angular'
      },
      nzFooter: [
        {
          label: '确定',
          type: 'primary',
          onClick: (componentInstance) => console.log(componentInstance.name)
        },
        {
          label: '取消',
          onClick: (componentInstance) => console.log(componentInstance.name)
        }
      ]
    });
  }
}

4.分页（Pagination）
分页用于将长列表分解为一页一页的内容。它可以设置每页显示多少条内容，并提供翻页回调函数。

import { Component } from '@angular/core';
import { PaginationComponent } from '@delon/abc';

@Component({
  selector: 'app-my-component',
  templateUrl: './my.component.html'
})
export class MyComponent {
  pageNo = 1;
  pageSize = 10;
  totalCount = 100;

  onPageIndexChange(pageIndex: number): void {
    this.pageNo = pageIndex;
    this.getList();
  }

  onPageSizeChange(pageSize: number): void {
    this.pageSize = pageSize;
    this.getList();
  }
}

5.查询表单（SearchForm）
查询表单用于帮助用户构建复杂的查询表单。它可以设置多个查询条件，并提供查询回调函数。

import { Component } from '@angular/core';
import { FormGroup, FormBuilder } from '@angular/forms';
import { SearchFormComponent } from '@delon/abc';

@Component({
  selector: 'app-my-component',
  templateUrl: './my.component.html'
})
export class MyComponent {
  searchForm: FormGroup;

  constructor(private fb: FormBuilder) {
    this.searchForm = this.fb.group({
      name: [''],
      phone: [''],
      status: [null]
    });
  }

  onQuery(): void {
    console.log(this.searchForm.value);
  }
}

@Component({
 selector: 'app-home',
 template: `
 <sf [schema]="schema" [ui]="ui" (formSubmit)="submit($event)"></sf>
 `
})
export class HomeComponent {
 schema: SFSchema = {
  properties: {
   email: {
    type: 'string',
    title: '邮箱',
    format: 'email',
    maxLength: 20
   },
   name: {
    type: 'string',
    title: '姓名',
    minLength: 3
   },
   mobileNumber: { type: 'string', title: '手机号', pattern: '^1[0-9]{10}$' },
  },

 };

 ui: SFUISchema = {
  '*': {
   spanLabelFixed: 100,
   grid: { span: 24 },
  },
  $mobileNumber: {
   widget: 'string',
   errors: { 'pattern': '请输入11位手机号码' }
  }
 };

 submit(value: any) {

 }
}

四、总结
ngalain是一个非常强大的Angular工具集，它包含了许多功能强大、易于使用的组件、样式和工具函数，可以 significantly enhance我们的开发体验和效率。如果您正在开发大型的Angular应用程序，我们强烈建议您使用ngalain。