Angular Academy · Урок

Сущности и пользовательские возможности

Управляйте коллекциями с помощью withEntities

«Сущности и пользовательские возможности» — бесплатный урок Angular Academy на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Angular Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Angular Academy содержит 4 уроков всего.

Управление коллекциями

Списки записей (задачи, пользователи, товары) встречаются настолько часто, что NgRx предоставляет withEntities для управления ими с нормализованным состоянием и готовыми функциями обновления.

withEntities

withEntities хранит элементы, сгруппированные по идентификатору, в entityMap и упорядоченном массиве ids, а также предоставляет вычисляемый сигнал entities со списком.

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

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

Функции обновления сущностей

Используйте вспомогательные функции обновления вместе с patchState: setAllEntities, addEntity, updateEntity, removeEntity. Они поддерживают согласованность карты и порядка идентификаторов.

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'));

Загрузка коллекции

После получения данных заменяйте всю коллекцию с помощью setAllEntities: эта функция нормализует массив в карту и массив идентификаторов.

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

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

Пользовательский idKey

Если идентификатор сущности называется не id, передайте селектор. Тогда хранилище будет использовать это поле как ключ карты.

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

Получение производных данных из сущностей

Объедините withEntities с withComputed, чтобы создавать модели чтения с фильтрацией или подсчётом на основе коллекции.

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

Что такое пользовательская функциональная возможность

Пользовательская функциональная возможность — это повторно используемый набор состояния, вычисляемых значений и методов, который можно добавлять в разные хранилища. Создайте его с помощью signalStoreFeature.

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

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

Повторное использование функциональной возможности

Добавляйте пользовательскую функциональную возможность в любое хранилище так же, как встроенную. Так можно разделять сквозные аспекты, например признаки загрузки или разбиение на страницы.

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

Функциональные возможности с методами

Пользовательская функциональная возможность может включать withMethods для предоставления повторно используемого поведения, например вспомогательных методов setLoading.

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

Композиция

Поскольку функциональные возможности — это обычные функции, возвращающие описатели возможностей, их можно объединять в любом количестве: withLoading(), withEntities() и специфичное для приложения состояние — всё сливается в одно хранилище со строгой типизацией.

Обобщённые функциональные возможности

Сделайте возможности обобщёнными, чтобы они работали с разными типами сущностей. Параметры типов передаются дальше, поэтому потребители сохраняют полную типобезопасность.

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

Быстрая проверка

Проверьте свои знания о сущностях и возможностях.

Итоги

Вы управляли коллекциями с помощью withEntities (нормализованная карта, вспомогательные функции для обновления, производные модели чтения) и создали повторно используемые обобщённые наборы signalStoreFeature для совместного использования состояния, вычисляемых значений и методов в разных хранилищах.

Часто задаваемые вопросы

Урок «Сущности и пользовательские возможности» бесплатный?

Да — полный текст урока «Сущности и пользовательские возможности» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Angular Academy, подпишись на CoddyKit PRO. Курс Angular Academy содержит 4 уроков всего.

Чему я научусь в уроке «Сущности и пользовательские возможности»?

Управляйте коллекциями с помощью withEntities Ты практикуешь Angular Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Angular Academy?

Предыдущий опыт не требуется. Angular Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.

Сколько времени занимает урок «Сущности и пользовательские возможности»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Angular Academy?

Да. Каждый урок Angular Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к Angular Academy