vue 2.2.1
vuex 2.3.1
でお送りします。

準備

今回はvue-cliのwebpackで試してみます。
インストールしていない場合は下記で vue-cli をグローバルにインストール。

$ sudo npm install -g vue-cli

これでvueコマンドが使えるので、プロジェクトを作成しカレントにします。

$ vue init webpack-simple vuex-test
$ cd vuex-test

npmパッケージをプロジェクトにインストールします。
vuexとbabel-plugin-transform-object-rest-spreadを追加でインストールしましょう。

$ npm install
$ npm install vuex -S
$ npm install babel-plugin-transform-object-rest-spread -D

babel-plugin-transform-object-rest-spread をインストールすることでJavaScriptの新しい機能を使用することができます。
ルートにある.babelrcpluginsに指定することで、この機能を使えるようにしましょう。

.babelrc

  1. {
  2. "presets": [
  3. ["latest", {
  4. "es2015": { "modules": false }
  5. }]
  6. ],
  7. "plugins": ["transform-object-rest-spread"]
  8. }

IE11対応

VuexはPromiseというのを使用していますが、IE11は対応していません。
これはbabel-polyfillをインストールすることで動くようになります。

npm install babel-polyfill -D

webpack.config.jsentryの部分を下記のようにします。

webpack.config.js

  1. entry: ["babel-polyfill", './src/main.js'],

これでVue+Vuexを使用する準備が整いました。
下記コマンドを実行すると自動的にブラウザが起動しVueのロゴが表示されるのを確認してください。

$ npm run dev

Vuexデータの流れ

下図はVuex公式ドキュメントで説明されている図です。

Vuexデータの流れ

細かい部分は置いといて、大きい流れは、
Vue ComponentsからActionsを実行する。
ActionsからMutationsを実行する。
MutationsStateを更新する。
Vue Componentsに反映される。
という流れになります。

コンポーネントだけで作成するTODOアプリ

簡単なTODOアプリをサンプルを作成してみます。
最初はVuexを使わないでコンポーネントだけで作成してみます。

src/App.vue

  1. <template>
  2. <div id="app">
  3. <ul>
  4. <item v-for="item in items" :item="item"></item>
  5. </ul>
  6. <div>
  7. <input type="text" v-model="inputTitle">
  8. <button @click="addItem">追加</button>
  9. </div>
  10. </div>
  11. </template>
  12. <script>
  13. import Item from './Item.vue';
  14. export default {
  15. name: 'app',
  16. components: { Item },
  17. data () {
  18. return {
  19. inputTitle: "",
  20. items: [
  21. {is_do: false, title: 'タスク1'},
  22. {is_do: true, title: 'タスク2'},
  23. {is_do: false, title: 'タスク3'}
  24. ]
  25. }
  26. },
  27. methods: {
  28. addItem() {
  29. this.items.push({
  30. title: this.inputTitle,
  31. is_do: false
  32. });
  33. }
  34. }
  35. }
  36. </script>

src/Item.vue

  1. <template>
  2. <li v-bind:class="{ 'is-do': item.is_do }" @click="done(item)">{{ item.title }}</li>
  3. </template>
  4. <script>
  5. export default {
  6. props: ['item'],
  7. methods: {
  8. done(item) {
  9. item.is_do = !item.is_do;
  10. }
  11. }
  12. }
  13. </script>
  14. <style lang="scss" scoped>
  15. li {
  16. cursor: pointer;
  17. }
  18. li.is-do {
  19. text-decoration: line-through;
  20. }
  21. </style>

機能としては、liをクリックするとis-doというクラスが付与されチェックされあた状態となります。
追加ボタンをクリックすると新しいタスクが追加されます。
この部分は単純なVue.jsの作りなので説明は省略します。

このくらいならコンポーネント分ける必要ないのですが、一つだけだとVuexのサンプルとしてわかりにくいのかなと。

Storeファイルのstateのデータを表示する

まずは、Storeファイルにstateを作成して、その内容をコンポーネントで表示するという部分をだけを作成してみます。
src/storeディレクトリにindex.jsというファイル名で作成します。

src/store/index.js

  1. import Vue from 'vue'
  2. import Vuex from 'vuex'
  3. Vue.use(Vuex)
  4. export default new Vuex.Store({
  5. state: {
  6. items: [
  7. {is_do: false, title: 'タスク1'},
  8. {is_do: true, title: 'タスク2'},
  9. {is_do: false, title: 'タスク3'}
  10. ]
  11. }
  12. });

Vue、Vuexをインポートしたら、Vue.use(Vuex)でVuexを使用できる状態にします。
いくつかVuexを使用するための記述がありますが、基本的にはsrc/App.vueにあったdataをそのままstateに書いているだけですね。

次にコンポーネントで設定したstateを表示してみましょう。
Storeのインポートはmain.jsで行います。

src/main.js

  1. import Vue from 'vue'
  2. import App from './App.vue'
  3. import store from './store';
  4.  
  5. new Vue({
  6. store,
  7. el: '#app',
  8. render: h => h(App)
  9. })

src/App.vueitemsの中をthis.$store.state.itemsに変更します。

src/App.vue

  1. import Item from './Item.vue'
  2.  
  3. export default {
  4. name: 'app',
  5. components: {
  6. Item
  7. },
  8. data () {
  9. return {
  10. items: this.$store.state.items,
  11. inputTitle: ""
  12. }
  13. }
  14. }

これでストアからstateのデータを読み込み表示することができました。

statemapStateを使用することで記述を簡略化することができます。

src/App.vue

  1. import { mapState } from 'vuex'
  2. import Item from './Item.vue'
  3.  
  4. export default {
  5. name: 'app',
  6. components: {
  7. Item
  8. },
  9. data () {
  10. return {
  11. inputTitle: ""
  12. }
  13. },
  14. computed: {
  15. ...mapState(['items'])
  16. }
  17. }

インポートでmapStateを読み込んだら。computed...mapState(['items'])を追記します。これでdetaitemsを設定する必要がなくなります。

「…」が奇妙な感じですが「オブジェクトスプレッド演算子」という機能です。

main.jsStoreをインポートしておけば、どのコンポーネントからもデータを取り出せるので便利ですね。

mutation-types.jsの作成

stateから取得する方法がわかったので次はActionsMutationsを作成して、stateを更新できるようにしてみましょう。

「TODOをチェックする(DONE_TASK)」と「TODOを追加する(ADD_TASK)」というアクションを作成していきます。
早速アクションを書き始めてもいいのですが、その前にmutation-types.jsを作成します。
別ファイルにすることでストアとコンポーネントで使えるようにします。

src/store/mutation-types.js

  1. export const ADD_TASK = 'ADD_TASK';
  2. export const DONE_TASK = 'DONE_TASK';

定数に文字列を代入しているだけですが、こうすることでlintやコードの補間ができたりと便利らしいです。

ストアで使えるようにインポートしておきましょう。

src/store/index.js

  1. import * as types from './mutation-types'

Actionsの作成

今度こそアクションを作成していきましょう。
src/store/index.jsstateの下に下記を追記します。

src/store/index.js

  1. actions: {
  2. [types.ADD_TASK] ({ commit }, title) {
  3. let newItem = {
  4. title: title,
  5. is_do: false
  6. }
  7. commit( types.ADD_TASK, {
  8. data: newItem
  9. })
  10. },
  11. [types.DONE_TASK] ({ commit }, item) {
  12. commit( types.DONE_TASK, {
  13. data: item
  14. })
  15. }
  16. }

関数名の部分が配列みたいになってまた奇妙な感じになってますが、こうすることで定数を関数名として使用できるようになります。

commitを実行することでミューテーションが実行されます。
ここでは値を渡したかったので第2引数に設定しています。

今回のような値を渡すだけならアクションは必要ないと思いますが、今後サーバーとのやり取りをする場合はこのActionsに記述していくことになります。

commitの部分は次のような書き方もできます。

  1. commit({
  2. type: types.DONE_TASK,
  3. data: item
  4. })

Mutationsの作成

先ほど作成したActionsの下に下記を追記します。

src/store/index.js

  1. mutations: {
  2. [types.ADD_TASK] (state, payload) {
  3. state.items.push(payload.data);
  4. },
  5. [types.DONE_TASK] (state, payload) {
  6. let index = state.items.indexOf(payload.data)
  7. state.items[index].is_do = !payload.data.is_do
  8. }
  9. },

アクションで設定した引数はpayloadに入っています。
dataプロパティに設定したのでpayload.dataで取り出せます。
あとは普通にstateの配列を書き換えているだけですね。

Componentsで使う

最後にコンポーネントからアクションを実行してステートを更新してみましょう。

まずはTODOをチェックするアクションです。
これはItem.vueで設定してましたね。

src/Item.vue

  1. <template>
  2. <li v-bind:class="{ 'is-do': item.is_do }" @click="DONE_TASK(item)">{{ item.title }}</li>
  3. </template>
  4.  
  5. <script>
  6. import { mapActions } from 'vuex'
  7. import * as types from './store/mutation-types';
  8.  
  9. export default {
  10. props: ['item'],
  11. methods: {
  12. ...mapActions([
  13. types.DONE_TASK
  14. ])
  15. }
  16. }
  17. </script>

ステートと同じでアクションにはmapActionsというヘルパーが用意されています。
methodsではこれを使用して、使いたいアクションtypes.DONE_TASKを指定します。
あとはタグの部分の@clickDONE_TASK(item)に変更しましょう。

同じ要領でApp.vueも作成してみましょう。

src/App.vue

  1. <template>
  2. <div id="app">
  3. <ul>
  4. <item v-for="item in items" :item="item"></item>
  5. </ul>
  6. <div>
  7. <input type="text" v-model="inputTitle">
  8. <button @click="ADD_TASK(inputTitle)">追加</button>
  9. </div>
  10. </div>
  11. </template>
  12.  
  13. <script>
  14. import { mapState,mapActions } from 'vuex'
  15. import * as types from './store/mutation-types';
  16. import Item from './Item.vue'
  17.  
  18. export default {
  19. name: 'app',
  20. components: {
  21. Item
  22. },
  23. data () {
  24. return {
  25. inputTitle: ""
  26. }
  27. },
  28. computed: {
  29. ...mapState(['items'])
  30. },
  31. methods: {
  32. ...mapActions([
  33. types.ADD_TASK
  34. ]),
  35. }
  36. }
  37. </script>

いろいろ間違っているところがあると思いますが、以上になります。
複雑なとこもありますが、一つ一つ見ていくことでなんとなくわかってきたような気がしないでもないです。

作ったものはGithubに置いてあります。
参考サイト
Vuex Introduction
Vue.js + Vuexで開発をしてみよう!