Cad is NgModule ann?

Question

Accepted Answer

Is **NgModule** a runda ann a bhfuil an deabhóir `@NgModule` air a dhéanann grúpáil ar chomhpháirteanna, treoraithe, píopaí agus seirbhísí gaolmhara ina bhloc comhéifeachtúil, ag insint do Angular conas iad a thiomsú agus a bhealadh le chéile. (Nóta: is fearr le Angular nua-aimseartha **comhpháirteanna neamhspleách** a úsáid seachas NgModules, ach tá tuiscint ar NgModules fós riachtanach do fhormhór na mbunchóid atá ann cheana féin.)

## Anatamaíochta 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 {}
```

## An ceithre eagar dhílis

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

Ní féidir comhpháirt a dhearbhú ach i **modules** amháin, agus caithfear a dearbhú (nó a iompórtáil mar neamhspleách) chun a bheith in úsáid i dtemplaid an mhodúil sin.

## An módúl fréamhaigh

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

Tá `AppModule` fréamhaigh ag gach feidhmchlár (neamh-neamhspleách) le eagar `bootstrap` ag ainmniú an chomhpháirt tosaithe.

## Modúil ghné agus eagrúchán

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

Tá feidhmchláir eagraithe ina **modúil ghné** (ceann in aghaidh an réimse domain) agus **modúl roinnte** (comhpháirteanna/píopaí coitianta), ag coimeád an bhunchóid modúlach agus ag cumasú ualaigh thuama in aghaidh an ghné.

## An athrú go neamhspleách

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

Ligann Angular nua-aimseartha do chomhpháirteanna a bheith **neamhspleách** — ag dearbhú a gcuid spleáchais féin go díreach — ag laghdú nó ag fágáil ar lár an boilerplate NgModule.

## Cén fáth a bhfuil sé tábhachtach

NgModules an dóigh thraidisiúnta d'eagrúchán agus de dhraenáil spleáchais Angular — tá tuiscint ar `declarations`/`imports`/`exports`/`providers` riachtanach chun a bhformhór feidhmchláir Angular atá ann a nascleanadh agus chun tuiscint a fháil ar thualaich thuama.

Cé go bhfuil an cód nua ag claonadh i dtreo comhpháirteanna neamhspleách, tá an t-eolas NgModule fós riachtanach do shaothar Angular i saol an-fhíor.