angular2 NgModel` 模块

48次阅读

共计 2537 个字符,预计需要花费 7 分钟才能阅读完成。

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’ 指明了模块的路径,和模块的名称。

正文完
 0