使用第三方类库

除了 NG-ZORRO 基础组件以及 @delon 业务组件以外,有时我们还需要引用其他外部类库,以下将介绍如何使用富文本组件 ngx-tinymce

Angular组件

安装依赖包

  1. yarn add ngx-tinymce

注册

像富文本框你可能需要在所有子模块中都会可能会用到,因为建议在 SharedModule 模块中导入和导出他。

  1. // #region third libs
  2. import { NgxTinymceModule } from 'ngx-tinymce';
  3. const THIRDMODULES = [ NgxTinymceModule ];
  4. // #endregion

region: third libs 区域是NG-ALAIN的一个编码约定,将所有第三方组件注册至 THIRDMODULES 变量中即可,而无须关心 @NgModule 内在的写法,有关更多编码约定可以参考编码规范建议

对于部分第三方组件,可能会需要一些配置项,建议在根模块中注册,例如:

  1. import { NgxTinymceModule } from 'ngx-tinymce';
  2. @NgModule({
  3. imports: [
  4. BrowserModule,
  5. NgxTinymceModule.forRoot({
  6. baseURL: '//cdn.bootcss.com/tinymce/4.7.13/'
  7. })
  8. ]
  9. })
  10. export class AppModule { }

接下来你可以在任何子模块中使用 ngx-tinymce

  1. <tinymce [(ngModel)]="html"></tinymce>

非Angular组件

引用一个非 Angular 组件实际上是一个 JavaScript 类库,例如二维码类库 qrious,这是一个纯洁的 JavaScript 类库(建议尽可能使用纯洁类库而非带有依赖其他)。

安装依赖包

  1. yarn add qrious

导入脚本

angular.json 找到 scripts 节点并增加:

  1. "scripts": [
  2. "node_modules/qrious/dist/qrious.min.js"
  3. ]

如果第三方类库需要额外的样式,还需要在 styles 增加路径。

注意:需要重新运行 ng s 才会生效。

延迟加载脚本

上述导入脚本方式会把代码直接打包进 scripts.js,这会导致 scripts.js 体积变大,NG-ALAIN 提供另一种延迟加载CDN类库脚本解决方案,适用低使用率的业务(例如:zip 压缩),可以利用 LazyService 延迟加载远程CDN脚本。

使用

Angular 是采用 TypeScript 语言,所有类型都必须明确定义才能使用,细节请参考 Angular 如何使用第三方库

一个调用的示例代码:

  1. declare var QRious: any;
  2. @Component()
  3. export class DEMOComponent {
  4. constructor() {
  5. const qr = new QRious();
  6. }
  7. }