1. 说明
典型的模块是一个内聚的代码块,用来实现某种单一的功能。Angular2应用程序本质上是有一系列模块组成的,而且Angular 本身就是一组模块库。模块主要是导出一些东西——类,函数,值,供其它模块导入,然后使用这个类,函数或者值。Angular2 应用是模块化的,并且 Angular2 有自己的模块系统,它被称为 Angular2 模块 或 NgModules。
NgModules是带有 @NgModule 装饰器函数的 类 。 @NgModule
接收一个元数据对象,该对象告诉 Angular 如何编译和运行模块代码。它标记出该模块拥有的组件,指令和管道,引入的其他Angular2模块,以及导出给其他模块使用的公共部分,同时还可以向当前模块注入对应的服务提供商等。
模块是组织应用程序和使用外部程序库的最佳途径。很多 Angular 库都是模块,比如: FormsModule
、 HttpModule
、 RouterModule
。模块可能在应用启动时主动加载,也可能由路由器进行异步 惰性加载。
每个Angular2应用都必须存在唯一一个根模块,我们将通过引导根模块来启动应用。
2. 实例
Angular2模块一般由注解,元数据以及模块类组成,来看下面的这个简单的组件的例子:
import { NgModule } from ‘@angular/core‘; import { FormsModule, ReactiveFormsModule } from ‘@angular/forms‘; import { PortalComponent } from ‘./portal‘; import { routing } from ‘./routes‘; @NgModule({ imports: [ routing, FormsModule, ReactiveFormsModule ], exports: [], declarations: [PortalComponent], providers: [] }) export class PortalModule { } |
以上的例子可以看出,我们通过元数据imports导入了FormsModule等其他Angular2模块,通过declarations声明当前模块中使用的组件等,当然,我们还可以通过exports导出公共部分提供其他模块使用,以及providers提供了当前模块所使用的服务提供商。
3. 定义
通过官方提供的NgModule的API我们可以知道,其元数据的描述如下。
interface NgModule { providers : Provider[] declarations : Array<Type<any>|any[]> imports : Array<Type<any>|ModuleWithProviders|any[]> exports : Array<Type<any>|any[]> entryComponents : Array<Type<any>|any[]> bootstrap : Array<Type<any>|any[]> schemas : Array<SchemaMetadata|any[]> id : string } |
我们分别对这些属性加以说明:
l providers : Provider[]
注入在该模块中使用的服务提供商,在根模块注入的服务供应商可以供整个应用程序使用。
l declarations : Array<Type<any>|any[]>
声明在该模块中使用的组件,指令以及通道
l imports : Array<Type<any>|ModuleWithProviders|any[]>
导入在该模块中使用的其他Angular2模块中的组件,指令以及管道等,该模块中的组件等由exports属性导出。
l exports : Array<Type<any>|any[]>
导出该模块中的组件,指令以及管道等,以便提供给其他Angular2模块使用。
l entryComponents : Array<Type<any>|any[]>
声明在模块定义时进行编译的组件,当模块加载的时候回生成ComponentFactory并保存在ComponentFactoryResolver,使用ComponentFactoryResolver创建组件的时候应该现在此处进行声明。
l bootstrap : Array<Type<any>|any[]>
此处声明当模块启动加载的时候同时执行启动加载的组件,这些组件会自动添加到entryComponents中。
l schemas : Array<SchemaMetadata|any[]>
声明在Angular中使用的非组件,指令或管道等Angular标准元素或者属性的其他自定义元素或属性信息。常用的schemas形式有:
NO_ERRORS_SCHEMA: 所有的元素或者属性均可以
CUSTOM_ELEMENTS_SCHEMA:任意元素(元素标签中包含“-”)和属性都可以
l id : string
一个独立的模块ID,用来在getModuleFactory标识对应的模块,如果设定对应的ID信息,这不会在getModuleFactory中注入。