# Angular 18 Signals: nowe API reaktywne i detekcja zmian bez Zone.js

> Kompletny przewodnik po Angular 18 Signals: input(), model(), viewChild(), tryb zoneless. Praktyczne przykłady kodu i migracja istniejących komponentów.

- Published: 2026-01-18
- Updated: 2026-04-10
- Author: SharpSkill
- Tags: angular 18, angular signals, zoneless, signal inputs, reactivity
- Reading time: 12 min

---

Angular 18 wyznacza punkt zwrotny w ewolucji frameworka dzięki stabilizacji Signals. Ten nowy reaktywny prymityw fundamentalnie zmienia sposób budowania komponentów Angular, oferując nowoczesną alternatywę dla tradycyjnych dekoratorów i torując drogę do detekcji zmian bez Zone.js.

> **Czego można się nauczyć**
>
> API oparte na sygnałach w Angular 18: input(), model(), viewChild() oraz konfiguracja zoneless dla lżejszych i wydajniejszych aplikacji.

## Zrozumienie Signals w Angular 18

Signals to nowe podejście do reaktywności w Angular. W odróżnieniu od klasycznych dekoratorów takich jak `@Input()`, które opierają się na detekcji zmian przez Zone.js, Signals oferują precyzyjną i jawną reaktywność. Każdy Signal enkapsuluje wartość i automatycznie powiadamia konsumentów o jej zmianie.

Takie podejście niesie ze sobą kilka korzyści: lepsza wydajność dzięki ukierunkowanym aktualizacjom, natywna integracja z funkcjami `computed()` i `effect()` oraz przygotowanie na przyszłość Angular bez Zone.js.

```typescript
// signals-basics.component.ts
// Demonstration of fundamental Signal concepts
import { Component, signal, computed, effect } from '@angular/core';

@Component({
  selector: 'app-counter',
  standalone: true,
  template: `
    <div class="counter-container">
      <h2>Counter: {{ count() }}</h2>
      <p>Double: {{ doubleCount() }}</p>

      <button (click)="increment()">+1</button>
      <button (click)="decrement()">-1</button>
      <button (click)="reset()">Reset</button>
    </div>
  `
})
export class CounterComponent {
  // Writable signal - value can be modified
  count = signal(0);

  // Computed signal - automatically derived from count
  // Only recalculates when count changes
  doubleCount = computed(() => this.count() * 2);

  constructor() {
    // Effect - executed on every count change
    // Useful for side effects (logs, API calls, etc.)
    effect(() => {
      console.log(`New counter value: ${this.count()}`);
    });
  }

  increment() {
    // update() allows modification based on previous value
    this.count.update(value => value + 1);
  }

  decrement() {
    this.count.update(value => value - 1);
  }

  reset() {
    // set() directly replaces the value
    this.count.set(0);
  }
}
```

Signals działają jako reaktywne kontenery: `signal()` tworzy zapisywalny Signal, `computed()` wyprowadza obliczone wartości, a `effect()` pozwala wykonywać akcje w odpowiedzi na zmiany.

## Signal Inputs z input()

Funkcja `input()` zastępuje tradycyjny dekorator `@Input()`. Zwraca `InputSignal` tylko do odczytu, gwarantując, że dane zawsze płyną od rodzica do dziecka bez przypadkowej modyfikacji.

```typescript
// book-card.component.ts
// Component using signal inputs
import { Component, input, computed } from '@angular/core';

interface Book {
  id: string;
  title: string;
  author: string;
  price: number;
  discountPercent?: number;
}

@Component({
  selector: 'app-book-card',
  standalone: true,
  template: `
    <article class="book-card">
      <h3>{{ book().title }}</h3>
      <p class="author">By {{ book().author }}</p>

      @if (hasDiscount()) {
        <p class="price">
          <span class="original">\${{ book().price }}</span>
          <span class="discounted">\${{ discountedPrice() }}</span>
        </p>
      } @else {
        <p class="price">\${{ book().price }}</p>
      }

      @if (featured()) {
        <span class="badge">Featured</span>
      }
    </article>
  `
})
export class BookCardComponent {
  // Required input - template won't compile without this prop
  book = input.required<Book>();

  // Optional input with default value
  featured = input(false);

  // Computed based on input - automatically recalculated
  hasDiscount = computed(() => {
    const discount = this.book().discountPercent;
    return discount !== undefined && discount > 0;
  });

  // Discounted price calculation
  discountedPrice = computed(() => {
    const { price, discountPercent } = this.book();
    if (!discountPercent) return price;
    return (price * (100 - discountPercent) / 100).toFixed(2);
  });
}
```

Użycie w szablonie rodzica wygląda podobnie, ale z bezpieczeństwem typów i reaktywnością Signal:

```typescript
// book-list.component.ts
// Parent component using book-card
import { Component, signal } from '@angular/core';
import { BookCardComponent } from './book-card.component';

@Component({
  selector: 'app-book-list',
  standalone: true,
  imports: [BookCardComponent],
  template: `
    <div class="book-grid">
      @for (book of books(); track book.id) {
        <app-book-card
          [book]="book"
          [featured]="book.id === featuredBookId()"
        />
      }
    </div>
  `
})
export class BookListComponent {
  books = signal<Book[]>([
    { id: '1', title: 'Clean Code', author: 'Robert C. Martin', price: 35 },
    { id: '2', title: 'The Pragmatic Programmer', author: 'David Thomas', price: 42, discountPercent: 15 }
  ]);

  featuredBookId = signal('1');
}
```

Kluczowa różnica w porównaniu z `@Input()`: signal inputs są tylko do odczytu. Wywołanie `this.book.set()` z komponentu dziecka jest niemożliwe, co wzmacnia jednokierunkowy przepływ danych.

## Dwukierunkowe wiązanie z model()

W przypadkach wymagających dwukierunkowej synchronizacji Angular 18 wprowadza `model()`. Ta funkcja tworzy zapisywalny Signal, który automatycznie propaguje zmiany do komponentu rodzica.

```typescript
// search-input.component.ts
// Component with bidirectional binding via model()
import { Component, model, output, computed } from '@angular/core';

@Component({
  selector: 'app-search-input',
  standalone: true,
  template: `
    <div class="search-container">
      <input
        type="text"
        [value]="query()"
        (input)="onInput($event)"
        [placeholder]="placeholder()"
        class="search-input"
      />

      @if (query().length > 0) {
        <button (click)="clear()" class="clear-btn">×</button>
      }

      <span class="char-count">{{ charCount() }} characters</span>
    </div>
  `
})
export class SearchInputComponent {
  // model() creates a bidirectional Signal
  // Modifications propagate to parent
  query = model('');

  // Classic input for configuration
  placeholder = model('Search...');

  // Output for additional events
  searchSubmitted = output<string>();

  // Computed based on model
  charCount = computed(() => this.query().length);

  onInput(event: Event) {
    const value = (event.target as HTMLInputElement).value;
    // Update model - propagates to parent
    this.query.set(value);
  }

  clear() {
    this.query.set('');
  }

  submit() {
    if (this.query().length > 0) {
      this.searchSubmitted.emit(this.query());
    }
  }
}
```

Rodzic używa składni banana-in-a-box `[()]` do dwukierunkowego wiązania:

```typescript
// app.component.ts
// Using two-way binding with model()
import { Component, signal, effect } from '@angular/core';
import { SearchInputComponent } from './search-input.component';

@Component({
  selector: 'app-root',
  standalone: true,
  imports: [SearchInputComponent],
  template: `
    <div class="app-container">
      <app-search-input [(query)]="searchTerm" />

      <p>Current search: {{ searchTerm() }}</p>

      <div class="results">
        @for (result of filteredResults(); track result.id) {
          <div class="result-item">{{ result.name }}</div>
        }
      </div>
    </div>
  `
})
export class AppComponent {
  // Local signal synchronized with child component
  searchTerm = signal('');

  results = signal([
    { id: 1, name: 'Angular 18' },
    { id: 2, name: 'React 19' },
    { id: 3, name: 'Vue 3' }
  ]);

  // Reactive filtering based on searchTerm
  filteredResults = computed(() => {
    const term = this.searchTerm().toLowerCase();
    if (!term) return this.results();
    return this.results().filter(r =>
      r.name.toLowerCase().includes(term)
    );
  });
}
```

> **model() vs input()**
>
> Należy używać `input()` dla danych tylko do odczytu (rodzic → dziecko). `model()` stosuje się, gdy komponent dziecka musi modyfikować wartość (dwukierunkowo).

## Signal Queries z viewChild() i contentChild()

Funkcje `viewChild()`, `viewChildren()`, `contentChild()` i `contentChildren()` zastępują odpowiadające im dekoratory. Zwracają Signals, eliminując potrzebę hooków cyklu życia takich jak `ngAfterViewInit`.

```typescript
// form-container.component.ts
// Demonstration of signal queries
import {
  Component,
  viewChild,
  viewChildren,
  ElementRef,
  effect,
  signal
} from '@angular/core';
import { FormFieldComponent } from './form-field.component';

@Component({
  selector: 'app-form-container',
  standalone: true,
  imports: [FormFieldComponent],
  template: `
    <form #formElement (submit)="onSubmit($event)">
      <input #firstInput type="text" placeholder="Name" />

      <app-form-field label="Email" />
      <app-form-field label="Phone" />

      <div class="actions">
        <button type="submit">Submit</button>
        <button type="button" (click)="focusFirst()">Focus first field</button>
      </div>
    </form>
  `
})
export class FormContainerComponent {
  // viewChild returns Signal<ElementRef | undefined>
  formElement = viewChild<ElementRef>('formElement');

  // viewChild.required guarantees element exists
  firstInput = viewChild.required<ElementRef<HTMLInputElement>>('firstInput');

  // Query on a component - returns the component itself
  firstFormField = viewChild(FormFieldComponent);

  // viewChildren for multiple elements
  allFormFields = viewChildren(FormFieldComponent);

  constructor() {
    // Effect replaces ngAfterViewInit for queries
    effect(() => {
      // Signal is automatically resolved
      const input = this.firstInput();
      console.log('First input available:', input.nativeElement);
    });

    // React to list changes
    effect(() => {
      const fields = this.allFormFields();
      console.log(`${fields.length} form fields found`);
    });
  }

  focusFirst() {
    // Direct access via Signal
    this.firstInput().nativeElement.focus();
  }

  onSubmit(event: Event) {
    event.preventDefault();
    // Access the form
    const form = this.formElement();
    if (form) {
      console.log('Form submitted');
    }
  }
}
```

Do projekcji treści i dostępu do niej `contentChild()` działa analogicznie:

```typescript
// card.component.ts
// Using contentChild for projected content
import { Component, contentChild, contentChildren, TemplateRef } from '@angular/core';

@Component({
  selector: 'app-card',
  standalone: true,
  template: `
    <div class="card">
      <header class="card-header">
        <ng-content select="[card-title]" />
      </header>

      <div class="card-body">
        <ng-content />
      </div>

      @if (hasFooter()) {
        <footer class="card-footer">
          <ng-content select="[card-footer]" />
        </footer>
      }
    </div>
  `
})
export class CardComponent {
  // Detect if footer was projected
  footerContent = contentChild<ElementRef>('[card-footer]');

  // Computed to check footer presence
  hasFooter = computed(() => this.footerContent() !== undefined);
}
```

## Detekcja zmian bez Zone.js (Zoneless)

Angular 18 wprowadza detekcję zmian bez Zone.js w trybie eksperymentalnym. Ta funkcjonalność zmniejsza rozmiar bundle'a o około 13 KB i poprawia wydajność, eliminując monkey-patche na asynchronicznych API przeglądarki.

```typescript
// main.ts
// Configuring the application in zoneless mode
import { bootstrapApplication } from '@angular/platform-browser';
import { provideExperimentalZonelessChangeDetection } from '@angular/core';
import { AppComponent } from './app/app.component';

bootstrapApplication(AppComponent, {
  providers: [
    // Enable experimental zoneless detection
    provideExperimentalZonelessChangeDetection()
  ]
});
```

Konfiguracja `angular.json` również musi zostać zaktualizowana, aby usunąć Zone.js:

```json
{
  "projects": {
    "my-app": {
      "architect": {
        "build": {
          "options": {
            "polyfills": []
          }
        }
      }
    }
  }
}
```

W trybie zoneless detekcja zmian uruchamia się automatycznie w następujących przypadkach: aktualizacja Signala, wywołanie `markForCheck()`, nowa wartość otrzymana przez AsyncPipe lub dołączenie/odłączenie komponentu.

```typescript
// zoneless-counter.component.ts
// Component optimized for zoneless mode
import {
  Component,
  signal,
  ChangeDetectionStrategy,
  inject
} from '@angular/core';
import { HttpClient } from '@angular/common/http';
import { toSignal } from '@angular/core/rxjs-interop';

@Component({
  selector: 'app-zoneless-counter',
  standalone: true,
  // OnPush recommended for zoneless
  changeDetection: ChangeDetectionStrategy.OnPush,
  template: `
    <div class="counter">
      <p>Counter: {{ count() }}</p>
      <button (click)="increment()">Increment</button>

      @if (loading()) {
        <p>Loading...</p>
      }

      @if (data()) {
        <pre>{{ data() | json }}</pre>
      }
    </div>
  `
})
export class ZonelessCounterComponent {
  private http = inject(HttpClient);

  count = signal(0);
  loading = signal(false);
  data = signal<any>(null);

  increment() {
    // Signal update triggers detection
    this.count.update(c => c + 1);
  }

  async fetchData() {
    this.loading.set(true);

    try {
      // Signals guarantee view updates
      const response = await fetch('/api/data');
      const json = await response.json();
      this.data.set(json);
    } finally {
      this.loading.set(false);
    }
  }
}
```

> **Kompatybilność z trybem Zoneless**
>
> Komponenty korzystające z `ChangeDetectionStrategy.OnPush` i Signals są zasadniczo kompatybilne z trybem zoneless. Należy unikać bezpośrednich modyfikacji właściwości, które nie są Signals.

## Migracja istniejących komponentów

Migracja do API opartych na sygnałach może odbywać się stopniowo. Poniżej przykład refaktoryzacji tradycyjnego komponentu:

```typescript
// BEFORE: Component with classic decorators
// user-profile-legacy.component.ts
import { Component, Input, ViewChild, ElementRef, AfterViewInit } from '@angular/core';

@Component({
  selector: 'app-user-profile-legacy',
  template: `
    <div #container>
      <h2>{{ user.name }}</h2>
      <p>{{ user.email }}</p>
    </div>
  `
})
export class UserProfileLegacyComponent implements AfterViewInit {
  @Input() user!: { name: string; email: string };
  @ViewChild('container') container!: ElementRef;

  ngAfterViewInit() {
    console.log('Container ready:', this.container.nativeElement);
  }
}
```

```typescript
// AFTER: Component migrated to Signals
// user-profile.component.ts
import { Component, input, viewChild, ElementRef, effect } from '@angular/core';

interface User {
  name: string;
  email: string;
}

@Component({
  selector: 'app-user-profile',
  standalone: true,
  template: `
    <div #container>
      <h2>{{ user().name }}</h2>
      <p>{{ user().email }}</p>
    </div>
  `
})
export class UserProfileComponent {
  // input.required replaces @Input() with !
  user = input.required<User>();

  // viewChild.required replaces @ViewChild with !
  container = viewChild.required<ElementRef>('container');

  constructor() {
    // effect replaces ngAfterViewInit for queries
    effect(() => {
      console.log('Container ready:', this.container().nativeElement);
    });
  }
}
```

Korzyści z tej migracji: ściślejsze typowanie, automatyczna reaktywność, mniej szablonowego kodu i kompatybilność z trybem zoneless.

## Najlepsze praktyki z Signals

Kluczowe zalecenia, aby w pełni wykorzystać Signals w Angular 18:

```typescript
// best-practices.component.ts
// Example of best practices with Signals
import {
  Component,
  signal,
  computed,
  effect,
  untracked,
  ChangeDetectionStrategy
} from '@angular/core';

interface Product {
  id: string;
  name: string;
  price: number;
  quantity: number;
}

@Component({
  selector: 'app-cart',
  standalone: true,
  changeDetection: ChangeDetectionStrategy.OnPush,
  template: `
    <div class="cart">
      <h2>Cart ({{ itemCount() }} items)</h2>

      @for (item of items(); track item.id) {
        <div class="cart-item">
          <span>{{ item.name }}</span>
          <span>{{ item.quantity }} × \${{ item.price }}</span>
          <button (click)="removeItem(item.id)">Remove</button>
        </div>
      }

      <div class="cart-total">
        <strong>Total: \${{ total() }}</strong>
      </div>
    </div>
  `
})
export class CartComponent {
  // Signal for mutable data
  items = signal<Product[]>([]);

  // Computed for derived values - avoids unnecessary recalculations
  itemCount = computed(() => this.items().length);

  total = computed(() =>
    this.items().reduce((sum, item) => sum + item.price * item.quantity, 0)
  );

  constructor() {
    // Effect for side effects (analytics, persistence)
    effect(() => {
      const currentItems = this.items();
      // untracked avoids creating a dependency
      untracked(() => {
        localStorage.setItem('cart', JSON.stringify(currentItems));
      });
    });
  }

  addItem(product: Product) {
    // update() for modifications based on previous state
    this.items.update(current => {
      const existing = current.find(i => i.id === product.id);
      if (existing) {
        return current.map(i =>
          i.id === product.id
            ? { ...i, quantity: i.quantity + 1 }
            : i
        );
      }
      return [...current, { ...product, quantity: 1 }];
    });
  }

  removeItem(id: string) {
    this.items.update(current => current.filter(i => i.id !== id));
  }
}
```

Najważniejsze zasady:

- `computed()` powinno służyć do wartości pochodnych, zamiast przeliczać je w szablonie
- `update()` jest preferowane nad `set()`, gdy nowa wartość zależy od poprzedniej
- `untracked()` w efektach zapobiega cyklicznym zależnościom
- Atrybut `track` w pętlach `@for` jest obowiązkowy dla optymalizacji renderowania

## Podsumowanie

Angular 18 kładzie fundament pod przyszłość bez Zone.js dzięki Signals. Kluczowe wnioski:

- **input()** zastępuje `@Input()` ze ściślejszym typowaniem i gwarantowanym dostępem tylko do odczytu
- **model()** umożliwia reaktywne dwukierunkowe wiązanie między rodzicem a dzieckiem
- **viewChild()** i **contentChild()** eliminują potrzebę hooków cyklu życia
- **Zoneless** zmniejsza rozmiar bundle'a i poprawia wydajność
- **computed()** i **effect()** uzupełniają reaktywny ekosystem
- Stopniowa migracja jest możliwa komponent po komponencie

Adopcja Signals przygotowuje aplikacje Angular na przyszłe wersje, w których tryb zoneless stanie się normą. Ta transformacja stanowi rozsądną inwestycję w długoterminową utrzymywalność i wydajność.

---

Source: SharpSkill (https://sharpskill.dev), tech interview preparation for your real stack.
HTML version of this page: https://sharpskill.dev/pl/blog/angular/angular-18-signals-new-features