Vue.js on Railsパーフェクトガイド

# **概要**

薄いフレームワークとしてVue.jsが有名ですが、**規模が大きくなると結局たいへんなことになってしまうので、設計が必要です**。また、Railsでアプリケーションをつくる場合、Vue.jsのComponentチックな志向をうまく利用するのが一工夫必要かと思います。

そこで今回は、**Vue.js on Railsを、中~大規模開発に耐えうる、かつ、RailsとVue.jsのメリットを両方活かせる設計を考えてみました**。

「さくっとフレームワークを導入したい！」という方にはやや面倒かもしれませんが、逆に、この通りに作りさえすれば、あとはVue.jsなので、難解な概念が出てくることはありません（個人的には、少なくともこれくらい設計しないとフレームワークを導入する意味が無いのでは?・・・と感じますが）。**最初だけ頑張れば、あとは楽**ですし、jQueryもそのまま動きます。

※SPAなどではない、通常のRailsアプリケーションを想定しています
※Vue.jsの詳しい使い方はこの記事では紹介しません。

## 参考
* <a href="http://qiita.com/okmttdhr/items/3a6186c3542eda1b3630" target="_blank">Vue.jsで手軽じゃないアプリケーション構築 - Qiita</a>
* <a href="http://vuejs.org/guide/application.html" target="_blank">Building Larger Apps - vue.js</a>



# **ディレクトリ構成**
先にディレクトリ構成を示しておきます。アプリケーションのルートに`frontend`ディレクトリを作り、その中に以下の様な構成でファイルを作成します（node_modulesは省略）。

```
├── bower.json
├── gulpfile.js
├── package.json
└── src
    ├── app.coffee # 「app.~」をWebpackでapp/assets/javascriptにbundleすればよいようにJSを書く
    ├── app.movie.coffee # 「app.~」をWebpackでapp/assets/javascriptにbundleすればよいようにJSを書く。movieページで読み込むJS例
    ├── utils # 共通メソッド
    ├── components # 紐づくviewが存在するcomponent http://vuejs.org/guide/components.html
    ├── filters # フィルター http://vuejs.org/guide/custom-filter.html
    └── viewmodels # 基本的なscriptはすべてviewmodelで作成 http://vuejs.org/guide/index.html#ViewModel
```


# **モジュール管理**

Vue.jsにはAngularJsのようなモジュール管理の仕組みはないので、BrowserifyかWebpackをつかいます。

**できることに大差はないのですが、今回はWebpackを使いました**。

Webpackだと、**吐き出すファイルを複数にするのが容易**なので、各ページごとにJSをつくることができます。また、プラグイン等入れなくても全部のせな感じなので、のちのちのことを考えるとこちらかな、という理由です。

## 参考
* <a href="http://blog.uu59.org/2015-01-03-browerify-webpack.html" target="_blank">uu59のメモ | browserifyとwebpack</a>
* <a href="http://yutapon.hatenablog.com/entry/2014/12/06/123000" target="_blank">gulp.jsを使ってフロントエンドのビルドをする【webpack, stylus】 - yutaponのブログ</a>
* <a href="http://webpack.github.io/docs/optimization.html" target="_blank">optimization</a>
* <a href="http://clarkdave.net/2015/01/how-to-use-webpack-with-rails/" target="_blank">How to use webpack with Rails | clarkdave.net</a> - assets/javascriptはgitignoreするなど。


# **Componentsのつくりかた**

Railsのviewを活かしつつ、Componentをどのようにつくっていくかについて。まず、大きく分けて２つの方法があります。

## 方法

### 1.vueifyをつかって、".vueファイル（style, slim, jsがまとまったもの）"をcomponentにする
* Railsのviewファイルがあるにもかかわらずこれを使うのは相性が悪く、かなり工数を踏みそう。
* 現実的に難しい部分がある。

### 2.viewはRailsにpartialとしてつくり、componentのjsだけつくる。
* view側では、v-属性やidを指定し、特定要素にのみスクリプトが走るようなJSをかく。
* Railsチックにはなるが、SEOやレンダリングのことを考えるとこれ以上にベストな方法がなさそう。

## 結論
**2を採用。**

## 参考

* <a href="http://blog.uu59.org/2014-07-01-rails-vue-js.html" target="_blank">uu59のメモ | RailsとJS(vue.js)の連携</a>



# **ユニットテスト**

## 方法

### 1.CommonJS pre-processorを用いてKarmaを使う。
* サーバーサイドのテストをCapybaraでかいてあるため、mockを再び書くこととかがでてきてしまう。
* 全体としてコード量が増える

### 2.RailsのCapybaraに統一する。
* フロントエンドエンジニアがCapybaraを書く必要が出てくる。

## 結論

**2を採用。**



# **タスクランナー**
**Gulpを採用。**



# **パッケージ管理**
**npmを採用。**

Rails側には、bundleしたjsを読み込ませるだけにしたかったので、フロントのライブラリ管理のみgemは用いず、npmで管理します。また、WebpackでNodeモジュールを呼び出すのを基本想定としているため、Bowerは使用しません。フォルダ構成などは、以下の記事が詳しいです。

* <a href="https://speakerdeck.com/kazupon/vuejs-meetup" target="_blank">Railsで作られたサービスにVue.jsを導入したというお話</a>



# **サーバーとの通信**

API通信をどうするかですが、デメリットはないので、**<a href="https://github.com/visionmedia/superagent" target="_blank">superagent</a>を採用**。



# **共通処理**
AngularJsでいうサービスをどう作るかについてです。

これは、Vue.jsではComponentとDirectiveしかないので、utilsフォルダをつくり、その中に、**以下の様なmoduleをWebpackでつくることで対応**しています。

```coffeescript
module.exports = {
  open: (elm) ->
    target = elm.attr("href");
    $(".modal"+ target).fadeIn("fast");
    return false;
  close: (elm) ->
    elm.parents(".modal").fadeOut("fast");
    return false;
}
```

呼び出しは以下のように。

```coffeescript
utilModal = require('./../utils/modal')
module.exports = {
  el: '#test'
  methods: {
    modalOpen: (e) ->
      utilModal.open($(e.toElement))
    modalClose: (e) ->
      utilModal.close($(e.toElement))
  }
}
```

## 参考
* <a href="https://github.com/tastejs/todomvc/blob/master/examples/jquery/js/app.js" target="_blank">todomvc/app.js at master · tastejs/todomvc</a>
* <a href="https://speakerdeck.com/kazupon/vuejs-meetup" target="_blank">Railsで作られたサービスにVue.jsを導入したというお話</a>

# **まとめ**

ご意見ください。