Angular Academy · Lekcja

Tworzenie SignalStore

Definiować stan za pomocą signalStore i withState

Lekcja 1 z 413 kroki

Tworzenie SignalStore to bezpłatna lekcja Angular Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Angular Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Angular Academy zawiera 4 lekcji w sumie.

Czym jest SignalStore

NgRx SignalStore to lekkie rozwiązanie do zarządzania stanem, zbudowane na sygnałach Angulara. Sklep komponuje się z features, takich jak withState, withComputed i withMethods.

Instalacja

SignalStore znajduje się w pakiecie @ngrx/signals. Należy dodać go do projektu Angular, a następnie zaimportować potrzebne elementy składowe.

// terminal
// ng add @ngrx/signals
import { signalStore, withState } from '@ngrx/signals';

Fabryka signalStore

signalStore() zwraca klasę możliwą do wstrzyknięcia. Należy przekazać funkcje opisujące stan i zachowanie. Domyślnie sklep jest udostępniany w root.

export const CounterStore = signalStore(
  { providedIn: 'root' },
  withState({ count: 0 })
);

withState

withState(initial) definiuje stan początkowy. Każda właściwość najwyższego poziomu staje się sygnałem w sklepie, dlatego store.count jest sygnałem wywoływanym jako store.count().

withState({
  count: 0,
  user: null as User | null,
  items: [] as Item[]
});

Wstrzykiwanie sklepu

Ponieważ fabryka zwraca klasę możliwą do wstrzyknięcia, wstrzykują ją Państwo tak jak każdą usługę i odczytują sygnały stanu w szablonach.

@Component({
  template: '<p>{{ store.count() }}</p>'
})
export class CounterComponent {
  store = inject(CounterStore);
}

patchState

Stan SignalStore aktualizuje się za pomocą narzędzia patchState. Przyjmuje ono sklep oraz częściowe obiekty stanu lub funkcje aktualizujące i stosuje je w sposób niezmienny.

import { patchState } from '@ngrx/signals';

patchState(store, { count: 5 });
patchState(store, (s) => ({ count: s.count + 1 }));

Fragmenty stanu jako sygnały

Każdy klucz stanu jest udostępniany jako osobny sygnał. Odczyt jednego fragmentu nie wiąże go z pozostałymi, a szablony są aktualizowane tylko dla odczytywanych fragmentów.

// given withState({ count: 0, name: '' })
store.count();  // number signal
store.name();   // string signal

Typowanie stanu

Należy jawnie określać typ stanu dla pól dopuszczających wartość null lub będących tablicami, aby SignalStore wywnioskował prawidłowe typy sygnałów. W obiekcie początkowym należy używać rzutowań as.

type State = { user: User | null; loading: boolean };

withState<State>({ user: null, loading: false });

Zakres lokalny a root

Pominięcie providedIn tworzy sklep o zakresie komponentu; należy dodać sklep do właściwości providers komponentu. Dzięki temu każda instancja komponentu ma własny, odizolowany stan.

@Component({
  providers: [CounterStore]
})
export class WidgetComponent {
  store = inject(CounterStore);
}

Komponowanie funkcji

Siła SignalStore tkwi w komponowaniu: można wymienić wiele funkcji, które połączą się w jeden sklep. Kolejność ma znaczenie, ponieważ późniejsze funkcje mogą odczytywać wcześniejsze.

export const TodoStore = signalStore(
  withState({ todos: [] as Todo[] })
  // withComputed(...), withMethods(...) added next
);

Bez zbędnego kodu

W przeciwieństwie do klasycznego NgRx w stylu Redux (akcje, reduktory, efekty i selektory), SignalStore umieszcza stan i logikę w jednym deklaratywnym sklepie, wymagając znacznie mniej kodu pomocniczego.

Szybki test

Sprawdź swoją znajomość podstaw SignalStore.

Odpowiedz w interaktywnej lekcji

Podsumowanie

Utworzyli Państwo SignalStore za pomocą signalStore() i withState, odczytywali fragmenty stanu jako sygnały, aktualizowali je w sposób niezmienny przez patchState oraz wybierali między sklepami udostępnianymi w root a sklepami o zakresie komponentu. Następny temat: computed i metody.

Bezpłatny start

Ucz się HTML dzięki korepetycjom AI — za darmo

Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.

Kursy: 38
Lekcje: 144

Zacznij naukę bezpłatnie Wyświetl pełny kurs

Często zadawane pytania

Czy lekcja „Tworzenie SignalStore” jest bezpłatna?

Tak — pełny tekst „Tworzenie SignalStore” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Angular Academy, przejdź na CoddyKit PRO. Kurs Angular Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Tworzenie SignalStore”?

Definiować stan za pomocą signalStore i withState Ćwiczysz Angular Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Angular Academy?

Nie wymagamy żadnego doświadczenia. Angular Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.

Ile czasu zajmuje lekcja „Tworzenie SignalStore”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Angular Academy?

Tak. Każda lekcja Angular Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Angular Academy