angular2 NgModel` 模块

angular2 NgModel 模块

在 Angular2 中一个 Module 指的是使用 @NgModule 修饰的 class 。 @NgModule 利用一个元数据对象来告诉 Angular 如何去编译和运行代码。一个模块内部可以包含组件、指令、管道，并且可以将它们的访问权限声明为公有，以使外部模块的组件可以访问和使用到它们。我们也可以通过定义子模块来扩展我们应用的功能。

NgModule 的 API

interface NgModule {
     // providers: 这个选项是一个数组,需要我们列出我们这个模块的一些需要共用的服务
     //            然后我们就可以在这个模块的各个组件中通过依赖注入使用了.
    providers : Provider[]
     // declarations: 数组类型的选项, 用来声明属于这个模块的指令,管道等等.
     //               然后我们就可以在这个模块中使用它们了.
    declarations : Array<Type<any>|any[]>
     // imports: 数组类型的选项,我们的模块需要依赖的一些其他的模块,这样做的目的使我们这个模块
     //          可以直接使用别的模块提供的一些指令,组件等等.
    imports : Array<Type<any>|ModuleWithProviders|any[]>
     // exports: 数组类型的选项,我们这个模块需要导出的一些组件,指令,模块等;
     //          如果别的模块导入了我们这个模块,
     //          那么别的模块就可以直接使用我们在这里导出的组件,指令模块等.
    exports : Array<Type<any>|any[]>
    // entryComponents: 数组类型的选项,指定一系列的组件,这些组件将会在这个模块定义的时候进行编译
    //                  Angular会为每一个组件创建一个ComponentFactory然后把它存储在ComponentFactoryResolver
    entryComponents : Array<Type<any>|any[]>
    // bootstrap: 数组类型选项, 指定了这个模块启动的时候应该启动的组件.当然这些组件会被自动的加入到entryComponents中去
    bootstrap : Array<Type<any>|any[]>
    // schemas: 不属于Angular的组件或者指令的元素或者属性都需要在这里进行声明.
    schemas : Array<SchemaMetadata|any[]>
    // id: 字符串类型的选项,模块的隐藏ID,它可以是一个名字或者一个路径;用来在getModuleFactory区别模块,如果这个属性是undefined
    //     那么这个模块将不会被注册.
    id : string
 }

常用 API 简介

NgModule 的主要属性如下：

• declarations ：模块内部 Components/Directives/Pipes 的列表，声明一下这个模块内部成员，声明之后才能使用对应的组件等。
• providers ：指定应用程序的根级别需要使用的 service 。（ Angular2 中没有模块级别的 service ，所有在 NgModule 中声明的 Provider 都是注册在根级别的 Dependency Injector 中）
• imports ：导入其他 module ，其它 module 暴露的出的 Components 、 Directives 、 Pipes 等可以在本 module 的组件中被使用。比如导入 CommonModule 后就可以使用 NgIf、NgFor 等指令。
• exports ：用来控制将哪些内部成员暴露给外部使用。导入一个 module 并不意味着会自动导入这个 module 内部导入的 module 所暴露出的公共成员。除非导入的这个 module 把它内部导入的 module 写到 exports 中。
• bootstrap ：通常是 app 启动的根组件，一般只有一个 component 。 bootstrap 中的组件会自动被放入到 entryComponents 中。
• entryCompoenents : 不会再模板中被引用到的组件。这个属性一般情况下只有 ng 自己使用，一般是 bootstrap 组件或者路由组件， ng 会自动把 bootstrap 、路由组件放入其中。 除非不通过路由动态将 component 加入到 dom 中，否则不会用到这个属性。

子模块

随着程序的壮大，单一的根模块已不能清晰的划分职责，这时候便可以引入 Feature Module 。 Feature Module 与根模块的创建方式一样，所有的模块共享一个运行期上下文和依赖注入器。

功能模块与根模块的职责区别主要有以下两点：

• 根模块的目的在于启动app，功能模块的目的在于扩展app
• 功能模块可以根据需要暴露或隐藏具体的实现

Angular2 提供的另一个与模块有关的技术就是延迟加载了。默认情况下 Angular2 将所有的代码打包成一个文件，目的是为了提高应用的流畅性，但是如果是运行在 mobile 中的 app ，加载一个大文件可能会过慢，所以 rc5 提供了一种延迟加载方式。

import { ModuleWithProviders }  from '@angular/core';
import { Routes, RouterModule } from '@angular/router';

export const routes: Routes = [
  { path: '', redirectTo: 'contact', pathMatch: 'full'},
  { path: 'crisis', loadChildren: 'app/crisis/crisis.module#CrisisModule' }, // 可以延迟加载子模块，子模块的结构和父模块一样，它会去加载子模块中的Routes配置，并跳转对应的组件中去。
  { path: 'heroes', loadChildren: 'app/hero/hero.module#HeroModule' }
];

export const routing: ModuleWithProviders = RouterModule.forRoot(routes);

其中， path 指明路径， loadChildren 指明使用延迟加载， 'app/crisis/crisis.module#CrisisModule' 指明了模块的路径，和模块的名称。