# Estado ### Árvore simples de estado O Vuex usa uma **árvore de estado único** - isto é, este único objeto contém todo o seu nível de aplicativo e serve como _single source of truth_ (fonte única da verdade). Isso também significa que você terá apenas um _store_ para cada aplicativo. Uma única árvore de estado torna simples localizar um pedaço específico do estado, e nos permite facilmente tirar _snapshots_ do estado do aplicativo atual para fins de depuração. A árvore de um único estado não entra em conflito com a modularidade - em capítulos posteriores, discutiremos como dividir seu estado e mutações em sub-módulos. ### Obtendo o Vuex State em Vue Components Então, como exibimos o estado dentro do _store_ em nossos componentes do Vue? Uma vez que os _stores_ Vuex são reativos, a maneira mais simples de "recuperar" o estado é simplesmente retornar algum estado do _store_ dentro de um [dado computado](https://br.vuejs.org/v2/guide/computed.html): ``` js // vamos criar um componente de contador const Counter = { template: `
{{ count }}
`, computed: { count () { return store.state.count } } } ``` Sempre que o `store.state.count` muda, fará com que o dado computado seja reavaliado e ative as atualizações de DOM associadas. No entanto, esse padrão faz com que o componente dependa no singleton do _store_ global. Ao usar um sistema de módulo, ele precisa importar o _store_ em todos os componentes que usam o estado do _store_ e também requer _mocking_ ao testar o componente. O Vuex fornece um mecanismo para "injetar" o _store_ em todos os componentes filho do componente raiz com a opção `store` (habilitada por `Vue.use(Vuex)`): ``` js const app = new Vue({ el: '#app', // forneça o store usando a opção "store". // isso irá injetar a instância do _store_ em todos os componentes filho. store, components: { Counter }, template: `
` }) ``` Ao fornecer a opção _store_ para a instância raiz, o _store_ será injetado em todos os componentes filho da raiz e estará disponível neles como `this.$store`. Vamos atualizar a nossa implementação _Counter_ : ``` js const Counter = { template: `
{{ count }}
`, computed: { count () { return this.$store.state.count } } } ``` ### O auxiliar `mapState` Quando um componente precisa fazer uso de várias propriedades do estado do _store_ ou _getters_, declarar todos esses dados computados pode ser repetitivo e verboso. Para lidar com isso, podemos usar o auxiliar `mapState` que gera funções _getter_ computadas para nós, economizando algumas linhas de código: ``` js // em pleno desenvolvimento, os auxiliares são expostos como Vuex.mapState import { mapState } from 'vuex' export default { // ... computed: mapState({ // As arrow functions (ou funções de seta) podem tornar o código muito sucinto! count: state => state.count, // passar o valor da String 'count' é o mesmo que `state => state.count` countAlias: 'count', // para acessar o estado local com `this`, uma função normal deve ser usada countPlusLocalState (state) { return state.count + this.localCount } }) } ``` Também podemos passar um _Array_ de _Strings_ para `mapState` quando o nome de um dado computado mapeado é o mesmo que um nome de árvore secundária do estado. ``` js computed: mapState([ // map this.count to store.state.count 'count' ]) ``` ### Operador de propagação de objetos (_ES2015_ _Spread_ _Operator_ ) Observe que `mapState` retorna um objeto. Como usá-lo em combinação com outras propriedades locais computadas? Normalmente, teríamos que usar um utilitário para fundir vários objetos em um para que possamos passar o objeto final para `computado`. No entanto, com o [Spread Operator](https://github.com/sebmarkbage/ecmascript-rest-spread) (que é uma proposta de ECMAScript em estágio 3), podemos simplificar muito a sintaxe: ``` js computed: { localComputed () { /* ... */ }, // Misture isso no objeto externo com o Spread Operator ...mapState({ // ... }) } ``` ### Componentes ainda podem ter um estado local O uso do Vuex não significa que você deve colocar **tudo** no estado do Vuex. Embora colocar mais estado no Vuex torna suas mutações estatais mais explícitas e depuráveis, às vezes também pode tornar o código mais verboso e indireto. Se um pedaço de estado pertence estritamente a um único componente, pode ser bom deixá-lo apenas como um estado local. Você deve pesar os trade-offs e tomar decisões que atendam às necessidades de desenvolvimento da sua aplicação.