Criando um SignalStore
Defina o estado com signalStore e withState.
Criando um SignalStore é uma aula grátis de Angular Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Angular Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Angular Academy inclui 4 aulas no total.
O que é SignalStore
O SignalStore do NgRx é uma solução leve de gerenciamento de estado baseada em sinais do Angular. Você compõe um armazenamento a partir de funcionalidades como withState, withComputed e withMethods.
Instalação
O SignalStore está no pacote @ngrx/signals. Adicione-o ao seu projeto Angular e depois importe os blocos de construção necessários.
// terminal
// ng add @ngrx/signals
import { signalStore, withState } from '@ngrx/signals';Fábrica signalStore
signalStore() retorna uma classe injetável. Passe funcionalidades que descrevam o estado e o comportamento. Por padrão, o armazenamento é fornecido na raiz.
export const CounterStore = signalStore(
{ providedIn: 'root' },
withState({ count: 0 })
);withState
withState(initial) define o estado inicial. Cada propriedade de nível superior se torna um sinal no armazenamento, portanto store.count é um sinal que você chama como store.count().
withState({
count: 0,
user: null as User | null,
items: [] as Item[]
});Injetando o armazenamento
Como a fábrica retorna uma classe injetável, você a injeta como qualquer serviço e lê os sinais de estado em templates.
@Component({
template: '<p>{{ store.count() }}</p>'
})
export class CounterComponent {
store = inject(CounterStore);
}patchState
Atualize o estado do SignalStore com o auxiliar patchState. Ele aceita o armazenamento junto com objetos de estado parciais ou funções atualizadoras e aplica as alterações de forma imutável.
import { patchState } from '@ngrx/signals';
patchState(store, { count: 5 });
patchState(store, (s) => ({ count: s.count + 1 }));Partes do estado como sinais
Cada chave do estado é exposta como um sinal individual. Ler uma parte não cria dependência das outras, e os templates são atualizados apenas para as partes que leem.
// given withState({ count: 0, name: '' })
store.count(); // number signal
store.name(); // string signalTipando o estado
Defina explicitamente o tipo do estado para campos anuláveis ou de array, para que o SignalStore infira os tipos corretos dos sinais. Use conversões com as no objeto inicial.
type State = { user: User | null; loading: boolean };
withState<State>({ user: null, loading: false });Fornecido localmente ou na raiz
Omita providedIn para criar um armazenamento no escopo do componente; adicione o armazenamento ao providers do componente. Assim, cada instância do componente terá seu próprio estado isolado.
@Component({
providers: [CounterStore]
})
export class WidgetComponent {
store = inject(CounterStore);
}Compondo funcionalidades
O poder do SignalStore está na composição: liste várias funcionalidades e elas serão mescladas em um único armazenamento. A ordem importa, pois funcionalidades posteriores podem ler as anteriores.
export const TodoStore = signalStore(
withState({ todos: [] as Todo[] })
// withComputed(...), withMethods(...) added next
);Sem código repetitivo
Ao contrário do NgRx clássico no estilo Redux (ações, redutores, efeitos e seletores), o SignalStore mantém o estado e a lógica juntos em um único armazenamento declarativo, com muito menos código repetitivo.
Verificação rápida
Verifique seus conhecimentos básicos sobre SignalStore.
Recapitulação
Você criou um SignalStore com signalStore() e withState, leu partes do estado como sinais, atualizou-as de forma imutável por meio de patchState e escolheu entre armazenamentos fornecidos na raiz ou no escopo do componente. A seguir: computados e métodos.
Perguntas Frequentes
A aula “Criando um SignalStore” é grátis?
Sim — o texto completo de “Criando um SignalStore” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Angular Academy, atualize para CoddyKit PRO. O curso de Angular Academy inclui 4 aulas no total.
O que vou aprender em “Criando um SignalStore”?
Defina o estado com signalStore e withState. Você pratica Angular Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar Angular Academy?
Nenhuma experiência prévia é necessária. Angular Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “Criando um SignalStore”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de Angular Academy?
Sim. Cada aula de Angular Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Criando um SignalStore
- Computed e métodos
- rxMethod para operações assíncronas
- Entidades e funcionalidades personalizadas