Types of Feature Modules
There are five general categories of feature modules which tend to fall into the following groups:
- Domain feature modules.
- Routed feature modules.
- Routing modules.
- Service feature modules.
- Widget feature modules.
While the following guidelines describe the use of each type and their typical characteristics, in real world apps, you may see hybrids.
Feature Module | Guidelines |
---|---|
Domain | Domain feature modules deliver a user experience dedicated to a particular application domain like editing a customer or placing an order. They typically have a top component that acts as the feature root and private, supporting sub-components descend from it. Domain feature modules consist mostly of declarations. Only the top component is exported. Domain feature modules rarely have providers. When they do, the lifetime of the provided services should be the same as the lifetime of the module. Domain feature modules are typically imported exactly once by a larger feature module. They might be imported by the root |
Routed | Routed feature modules are domain feature modules whose top components are the targets of router navigation routes. All lazy-loaded modules are routed feature modules by definition. Routed feature modules don’t export anything because their components never appear in the template of an external component. A lazy-loaded routed feature module should not be imported by any module. Doing so would trigger an eager load, defeating the purpose of lazy loading.That means you won’t see them mentioned among the Routed feature modules rarely have providers for reasons explained in Lazy Loading Feature Modules. When they do, the lifetime of the provided services should be the same as the lifetime of the module. Don't provide application-wide singleton services in a routed feature module or in a module that the routed module imports. |
Routing | A routing module provides routing configuration for another module and separates routing concerns from its companion module. A routing module typically does the following:
A routing module should only be imported by its companion module. |
Service | Service modules provide utility services such as data access and messaging. Ideally, they consist entirely of providers and have no declarations. Angular's The root |
Widget | A widget module makes components, directives, and pipes available to external modules. Many third-party UI component libraries are widget modules. A widget module should consist entirely of declarations, most of them exported. A widget module should rarely have providers. Import widget modules in any module whose component templates need the widgets. |
The following table summarizes the key characteristics of each feature module group.
Feature Module | Declarations | Providers | Exports | Imported by |
---|---|---|---|---|
Domain | Yes | Rare | Top component | Feature, AppModule |
Routed | Yes | Rare | No | None |
Routing | No | Yes (Guards) | RouterModule | Feature (for routing) |
Service | No | Yes | No | AppModule |
Widget | Yes | Rare | Yes | Feature |
More on NgModules
You may also be interested in the following:
© 2010–2020 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v8.angular.io/guide/module-types