Kas yra NgModule?

Question

Kas yra NgModule?

Accepted Answer

**NgModule** yra klasė, dekoruota su `@NgModule`, kuri grupuoja susijusius komponentus, direktyvas, pipes ir servisus į darną bloką, nurodydama Angular, kaip juos kompiliuoti ir sujungti. (Pastaba: šiuolaikinė Angular vis labiau teikia pirmenybę **atskiriems komponentams** (standalone components) nei NgModules, tačiau NgModules suprasti vis dar būtina daugumoje esamų kodų bazių.)

## NgModule anatomija

```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 {}
```

## Keturi pagrindiniai masyvai

```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
```

Komponentas gali būti deklaruotas tik **viename** module ir turi būti deklaruotas (arba importuotas kaip standalone), kad būtų galima jį naudoti to modulio šablonuose.

## Šakninis modulis

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

Kiekviena (nestandalone) programa turi šaknį `AppModule` su `bootstrap` masyvu, kuriame nurodomas pradinis komponentas.

## Funkciniai moduliai ir organizacija

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

Programos yra organizuotos į **funkcinius modulius** (po vieną kiekvieno domeno sritį) ir **bendrą modulį** (bendri komponentai/pipes), palaikydamos kodų bazę moduline ir įgalindamos tingų užkrovimą kiekvienai funkcijai.

## Perėjimas prie atskiro komponento

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

Šiuolaikinė Angular leidžia komponentams būti **atskiriems** — tiesiogiai deklaruojant jų priklausomybes — sumažinant arba panaikinant NgModule nereikalingą kodą.

## Kodėl tai svarbu

NgModules yra tradicinis Angular organizavimo ir priklausomybių sujungimo mechanizmas — suprasti `declarations`/`imports`/`exports`/`providers` reikalinga naviguoti didžiąją dalį esamų Angular aplikacijų ir suprasti tingų užkrovimą.

Nors naujas kodas linkęs į atskirus komponentus, NgModule žinios lieka būtinos realaus pasaulio Angular darbui.