NgModule ni nini?

Question

NgModule ni nini?

Accepted Answer

**NgModule** ni darasa lililoandaliwa na `@NgModule` ambalo linaunganisha sehemu, maelezo, pipes na huduma zinazolingana katika kizuizi kinachounganisha, kikamata Angular jinsi ya kuziandaa na kuwaunganisha pamoja. (Kumbuka: Angular ya kisasa inapendelea **sehemu zinazojitegemea** kuliko NgModules, lakini kuelewa NgModules bado ni muhimu kwa umakini nyingi zilizosalia.)

## Anatomy ya NgModule

```ts
import { NgModule } from "@angular/core";
import { CommonModule } from "@angular/common";

@NgModule({
  declarations: [UserListComponent, UserCardComponent], // components/directives/pipes THIS module owns
  imports: [CommonModule, FormsModule],                 // other modules whose exports we need
  exports: [UserListComponent],                          // what we make available to importers
  providers: [UserService],                              // services (DI) provided by this module
})
export class UsersModule {}
```

## Safu nne muhimu

```text
declarations → components, directives, and pipes that BELONG to this module
imports      → other NgModules whose exported features this module needs
exports      → the subset of declarations/modules made available to importers
providers    → services registered for dependency injection
```

Sehemu inaweza kuelezwa tu katika **moduli moja** na lazima ielezewe (au kuingizwa kama inayojitegemea) ili itumike katika templeti za moduli hiyo.

## Moduli msingi

```ts
@NgModule({
  declarations: [AppComponent],
  imports: [BrowserModule, AppRoutingModule],
  bootstrap: [AppComponent], // the root component to launch
})
export class AppModule {}
```

Kila programu (isiyo na jitegemea) ina `AppModule` msingi na safu ya `bootstrap` inayoita sehemu ya kuanza.

## Moduli za sifa na mpango

```text
AppModule (root) → imports → UsersModule, AdminModule, SharedModule
```

Programu zinampango katika **moduli za sifa** (moja kwa kila eneo la kiufundi) na **moduli iliyoshirikiwa** (sehemu/pipes za kawaida), kuweka msimbo modular na kuwezesha ulaziaji wa kusubiri kwa sifa.

## Uhamiaji wa jitegemea

```ts
@Component({ standalone: true, imports: [CommonModule], ... }) // no NgModule needed
```

Angular ya kisasa inaruhusu sehemu kuwa **zinazojitegemea** — kueleza tegemezi zao mwenyewe moja kwa moja — kupunguza au kuondoa NgModule boilerplate.

## Kwa nini inafaa

NgModules ni utaratibu wa jadi wa kupanga na kuunganisha tegemezi katika Angular — kuelewa `declarations`/`imports`/`exports`/`providers` ni muhimu kupitia mlipuko mkubwa wa programu za Angular zilizosalia na kuelewa ulaziaji wa kusubiri.

Ingawa msimbo mpya unakabiliwa na sehemu zinazojitegemea, ujuzi wa NgModule bado ni mahalafu kwa kazi ya kweli ya Angular.