Angular Academy · Lektion

Entities und benutzerdefinierte Features

Sammlungen mit withEntities verwalten

Entities und benutzerdefinierte Features ist eine kostenlose Angular Academy-Lektion auf CoddyKit. Dies ist Lektion 4 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Angular Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Angular Academy-Kurs umfasst insgesamt 4 Lektionen.

Sammlungen verwalten

Listen von Datensätzen (Todos, Benutzern, Produkten) sind so häufig, dass NgRx mit withEntities eine Verwaltung mit normalisiertem Zustand und fertigen Updater-Funktionen bereitstellt.

withEntities

withEntities speichert Elemente anhand ihrer ID in einer entityMap sowie einem geordneten ids-Array und stellt ein berechnetes entities-Signal der Liste bereit.

import { withEntities } from '@ngrx/signals/entities';

export const TodoStore = signalStore(
  withEntities<Todo>()
);
// store.entities() -> Todo[]

Entity-Updater

Verwenden Sie Updater-Hilfsfunktionen mit patchState: setAllEntities, addEntity, updateEntity, removeEntity. Sie halten die Map und die Reihenfolge der IDs konsistent.

import { addEntity, removeEntity, updateEntity } from '@ngrx/signals/entities';

patchState(store, addEntity({ id: '1', title: 'A', done: false }));
patchState(store, updateEntity({ id: '1', changes: { done: true } }));
patchState(store, removeEntity('1'));

Eine Sammlung laden

Ersetzen Sie nach dem Abrufen die gesamte Sammlung mit setAllEntities. Die Funktion normalisiert das Array in die Map und die IDs.

import { setAllEntities } from '@ngrx/signals/entities';

load: rxMethod<void>(pipe(
  switchMap(() => api.getTodos()),
  tap(todos => patchState(store, setAllEntities(todos)))
))

Benutzerdefinierter idKey

Wenn der Bezeichner Ihrer Entity nicht id lautet, übergeben Sie einen Selektor. Der Store verwendet dann dieses Feld als Schlüssel der Map.

withEntities<User>(); // expects user.id
// custom key:
patchState(store, addEntity(user, { selectId: (u: User) => u.uuid }));

Werte aus Entities ableiten

Kombinieren Sie withEntities mit withComputed, um gefilterte oder gezählte Read Models auf Basis der Sammlung zu erstellen.

withComputed(({ entities }) => ({
  remaining: computed(() => entities().filter(t => !t.done).length)
}))

Was ist ein benutzerdefiniertes Feature

Ein benutzerdefiniertes Feature ist ein wiederverwendbares Paket aus Zustand, berechneten Werten und Methoden, das Sie in viele Stores integrieren können. Erstellen Sie es mit signalStoreFeature.

import { signalStoreFeature, withState } from '@ngrx/signals';

export function withLoading() {
  return signalStoreFeature(
    withState({ loading: false })
  );
}

Ein Feature wiederverwenden

Fügen Sie Ihr benutzerdefiniertes Feature wie ein integriertes Feature jedem Store hinzu. So teilen Sie übergreifende Belange wie Lade-Flags oder Pagination.

export const TodoStore = signalStore(
  withLoading(),
  withEntities<Todo>()
);
// store.loading() now exists

Features mit Methoden

Ein benutzerdefiniertes Feature kann withMethods enthalten, um wiederverwendbares Verhalten bereitzustellen, beispielsweise setLoading-Hilfsfunktionen.

export function withLoading() {
  return signalStoreFeature(
    withState({ loading: false }),
    withMethods((store) => ({
      setLoading(loading: boolean) { patchState(store, { loading }); }
    }))
  );
}

Komponierbarkeit

Da Features lediglich Funktionen sind, die Feature-Deskriptoren zurückgeben, können Sie viele kombinieren: withLoading(), withEntities() sowie anwendungsspezifischen Zustand – alles wird zu einem stark typisierten Store zusammengeführt.

Generische Features

Machen Sie Features generisch, damit sie für verschiedene Entitätstypen funktionieren. Typparameter werden durchgereicht, sodass Verbraucher die vollständige Typsicherheit behalten.

export function withSelected<T>() {
  return signalStoreFeature(
    withState({ selected: null as T | null })
  );
}

Schnelltest

Überprüfen Sie Ihr Wissen über Entitäten und Features.

Zusammenfassung

Sie haben Sammlungen mit withEntities verwaltet (normalisierte Map, Updater-Hilfsfunktionen und abgeleitete Lesemodelle) und wiederverwendbare, generische signalStoreFeature-Bundles erstellt, um State, berechnete Werte und Methoden über mehrere Stores hinweg gemeinsam zu nutzen.

Häufig gestellte Fragen

Ist die Lektion „Entities und benutzerdefinierte Features“ kostenlos?

Ja — der vollständige Text von „Entities und benutzerdefinierte Features“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Angular Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Angular Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Entities und benutzerdefinierte Features“?

Sammlungen mit withEntities verwalten Du übst Angular Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um Angular Academy zu starten?

Keine Vorkenntnisse erforderlich. Angular Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 4 von 4.

Wie lange dauert die Lektion „Entities und benutzerdefinierte Features“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser Angular Academy-Lektion Code schreiben und ausführen?

Ja. Jede Angular Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

Einen SignalStore erstellen
Computed und Methoden
rxMethod für asynchrone Aufgaben
Entities und benutzerdefinierte Features

← Zurück zu Angular Academy