Managing State with NgRx Store

Tutorial 3 of 5

Introduction

Welcome to our tutorial on managing state with NgRx Store in Angular. The goal of this tutorial is to provide a detailed guide on how you can use NgRx Store, a state management solution, to maintain consistency across your large Angular applications and optimize performance.

By the end of this tutorial, you'll learn:
- How to set up NgRx Store in your Angular application
- How to manage state using NgRx Store
- How to optimize performance with NgRx Store

This tutorial assumes that you have a basic understanding of Angular, TypeScript, and state management concepts.

Step-by-Step Guide

Understanding NgRx Store

NgRx Store is an implementation of Redux, a popular state management pattern, for Angular applications. It provides a single, immutable data store where you can keep all your application's state, making it predictable and consistent.

Setting Up NgRx Store

First, install NgRx Store in your Angular application:

npm install @ngrx/store

Then, define your application's state:

// app.state.ts

interface AppState {
  count: number;
}

const initialState: AppState = {
  count: 0,
};

Next, define a reducer function to handle state changes:

// app.reducer.ts

import { AppState } from './app.state';

export function appReducer(state: AppState, action: Action) {
  switch (action.type) {
    case 'INCREMENT':
      return { ...state, count: state.count + 1 };
    default:
      return state;
  }
}

Finally, configure the Store module in your application module:

// app.module.ts

import { StoreModule } from '@ngrx/store';
import { appReducer } from './app.reducer';

@NgModule({
  imports: [
    // ...
    StoreModule.forRoot({ count: appReducer }),
  ],
})
export class AppModule { }

Code Examples

Let's take a look at a practical example of how to use NgRx Store in an Angular component.

// counter.component.ts

import { Store } from '@ngrx/store';
import { AppState } from '../app.state';

@Component({
  // ...
})
export class CounterComponent {
  count$: Observable<number>;

  constructor(private store: Store<AppState>) {
    this.count$ = store.select('count');
  }

  increment() {
    this.store.dispatch({ type: 'INCREMENT' });
  }
}

In this example, we're using the Store service provided by NgRx Store to select the count state and dispatch an INCREMENT action. The count$ is an Observable that will emit the current count state whenever it changes.

Summary

In this tutorial, we've learned how to use NgRx Store to manage state in Angular applications. We've covered how to set up NgRx Store, define application state and reducer functions, and use the Store service to select and update state.

As next steps, you can explore other features of NgRx, such as effects for handling side effects and selectors for efficient state queries.

Practice Exercises

  1. Exercise 1: Implement a DECREMENT action in the reducer and dispatch it from the component.
  2. Exercise 2: Add a new message field to the application state and implement SET_MESSAGE and CLEAR_MESSAGE actions.

Here are the solutions:

  1. Solution 1:
// app.reducer.ts

export function appReducer(state: AppState, action: Action) {
  switch (action.type) {
    // ...
    case 'DECREMENT':
      return { ...state, count: state.count - 1 };
    default:
      return state;
  }
}

// counter.component.ts

decrement() {
  this.store.dispatch({ type: 'DECREMENT' });
}
  1. Solution 2:
// app.state.ts

interface AppState {
  count: number;
  message: string | null;
}

const initialState: AppState = {
  count: 0,
  message: null,
};

// app.reducer.ts

export function appReducer(state: AppState, action: Action) {
  switch (action.type) {
    // ...
    case 'SET_MESSAGE':
      return { ...state, message: action.payload };
    case 'CLEAR_MESSAGE':
      return { ...state, message: null };
    default:
      return state;
  }
}

// counter.component.ts

setMessage(message: string) {
  this.store.dispatch({ type: 'SET_MESSAGE', payload: message });
}

clearMessage() {
  this.store.dispatch({ type: 'CLEAR_MESSAGE' });
}

As a further exercise, you can try to implement a user authentication state and actions to log in and log out.