• ← 前回
• 連載 INDEX
• 次回 →

　前回は「2.2 コントローラの基本」を説明しました。本稿はその続きです。Railsアプリケーションの作成方法については、第1回から順にお読みください。

■

2.3　ビューの基本

　2.2節の例では説明の便宜上、コントローラから出力を直接生成しましたが、Model - View - Controllerの考え方からすると、これはあるべき姿ではありません。最終的な出力には、ERB（Embedded Ruby）テンプレートを利用するのが基本です。

　ERBテンプレートは、一言で言うならば、HTML*14にRubyスクリプトを埋め込む（embed）ためのしくみです（図2-8）。HTMLがベースにあるため、最終的な出力をイメージしながら開発を進められるというメリットがあります。

　その他、ERBテンプレートでは、以下のような特長があります。

• 任意のRubyスクリプトを埋め込めるので、条件分岐や繰り返し構文などの処理も自由に記述できる*15
• ビューヘルパー*16を利用することで、データベースから取得した値に基づいたリンクやフォーム要素などをシンプルなコードで生成できる

　Railsでは、その他にもBuilder、JBuilderのようなテンプレートエンジンを利用できますが*17、まずはERBを理解しておけば、基本的なビュー開発には十分です。

2.3.1　テンプレート変数の設定

　それではさっそく、具体的なサンプルを作成してみましょう。先ほどと同じく「こんにちは、世界！」というメッセージを表示するサンプルです。しかし、今度はコントローラクラスから直接に文字列を出力するのではなく、テンプレートファイルを経由して出力を生成します。

　テンプレートを利用する場合にも、まずはリクエスト処理の基点としてのコントローラクラス（アクションメソッド）を準備する必要があります。改めてコントローラクラスから作成しても構いませんが、ここでは、先ほど作成したhelloコントローラにviewアクションを追加するものとします（リスト2-3、追記部分は太字で表しています）。

　アクションメソッドが行うべき処理の中でも、ほとんどのアクションで欠かすことができないのがテンプレート変数の設定です。テンプレート変数とは、テンプレートファイルに埋め込むべき値のことで、アクションメソッドとビューとでデータを受け渡しするための橋渡し役となるものです。

　プログラム側で表示に必要なデータを用意しておき、テンプレート側ではデータを埋め込む場所や表示方法などを定義する、という役割分担がView - Controllerの基本的な関係です（図2-9）。

　Railsでテンプレート変数の役割を担うのは、インスタンス変数です。リスト2-3の例ではインスタンス変数として@msgを設定していますが、これがそのままテンプレート上でも自由に参照できる変数となるわけです。

　viewアクションではインスタンス変数@msgひとつに文字列を設定しているだけですが、もちろん複数の変数を設定することもできますし、値には文字列だけでなく、配列や任意のオブジェクトを設定することも可能です。

2.3.2　テンプレートファイルの作成

　続いて、アクションの結果を出力するためのテンプレートファイルを作成します。テンプレートファイルを単独で作成するためのコマンドはないので、ファイルは自分で作成する必要があります*18。

　テンプレートファイルは、/app/viewsフォルダ配下に「コントローラ名/ アクション名.html.erb」という名前で保存する必要があります。ここでは、helloコントローラのviewアクションに対応するテンプレートなので、「/hello/view.html.erb」を作成します。これによって、Railsはアクションメソッドを実行した後、対応するテンプレートを検索／実行します。

　では、テンプレートファイルの具体的なコードを見ていきましょう（リスト2-4）。

　例によって、ポイントとなる部分について順番に見ていきます。

1 動的な処理は< % … % > や< % = … % > で記述する

　テンプレートに対してRubyスクリプトを埋め込むには、< % … % > や< % = … % > のようなブロックを使います。

　< % … % > と< % = … % > はよく似ていますが、前者がただブロックの中のコードを実行するだけであるのに対して、後者は与えられた式を出力します。たとえば、以下のような例を見てみましょう。

　< % … % > で囲まれたコードは評価されるだけで結果を返しませんので、主に演算や制御構文の記述に利用します。1も演算結果が変数resultに格納されるのみで、結果（文字列）がテンプレートに挿入されることはありません。

　一方、< % = … % > では、式の評価結果をテンプレートに挿入します。よって、2では、変数resultの値が出力にも反映されます。

　テンプレートファイルの目的が画面に対してなんらかの出力を行うことであることを考えれば、条件分岐やループなどの制御命令を除けば、ほとんどは< % = … % >の形式で記述することになるでしょう。

2 テンプレート変数は「@変数名」で参照できる

　アクションメソッドで設定したテンプレート変数（インスタンス変数）は、テンプレート側でもそのまま「@変数名」の形式で参照できます。ごく直感的な記述ですので、迷うところはないでしょう*20。

　以上が理解できたら、さっそくサンプルを実行してみます。ブラウザから次のアドレスを指定し、図2-10のような結果が得られることを確認してください。

　　http://localhost:3000/hello/view

2.3.3　補足：共通レイアウトの適用

　リスト2-4の実行結果を、ブラウザの［ソースの表示］から確認してみましょう。

　テンプレートファイル（view.html.erb）で定義したものよりも随分多くのコンテンツが出力されていることが確認できます（view.html.erb以外による出力は太字で表しています）。

　これら自動で付与されているコンテンツは、実は/app/views/layouts/application.html.erbで定義されているものです*22。

　Railsではデフォルトで、application.html.erbの「< % = yield % >」に個別のテンプレートを埋め込んだ上で、最終的な出力を生成します。application.html.erbのことをレイアウトテンプレート、あるいは単にレイアウトと呼びます（図2- 11）。

　レイアウトとは、要はサイトデザインの外枠と考えれば良いでしょう。レイアウトを利用することで、ヘッダ／フッタやサイドメニューのようなサイト共通のデザインを一箇所にまとめられますので、以下のようなメリットがあります。

• サイトデザインを変更する場合もレイアウトだけを変更すれば良い
• 個別のテンプレートにはページ固有のコンテンツだけを記述すれば良い
• サイト構成（ナビゲーションなど）に一貫性ができるため、使い勝手も向上する

　開発生産性、保守性、ユーザの利便性いずれをとっても、外枠をレイアウトとして別に定義することの重要性はおわかりいただけるのではないでしょうか。

　レイアウトの詳細は改めて4.7節（※転載対象外です）で解説しますので、まずはRailsではデフォルトで

　　個別テンプレートにはレイアウトテンプレートが適用される

ことを覚えておいてください*23。

2.3.4　補足：コメント構文

　ERBテンプレートでは、以下のようなコメント構文を利用できます。以降でもよく利用しますので、ここでよく利用する記法をまとめておきます。

1 < % # … % >

　ERB標準のコメント構文で、< % #... % > ブロック配下をすべてコメントと見なします。「%」と「#」の間に空白を挟んではいけません。

2 #

　1とよく似ていますが、こちらはRuby標準のコメント構文で、< % ... % >ブロックの配下でのみ利用できます。こちらは「#」からその行末までがコメントと見なされます（単一行コメント）。

3 < % if false % > … < % end % >

　条件分岐構文を利用したコメントアウトです。条件式がfalseですので、常に配下のコンテンツは無視されるというわけです。2の構文は< % … % > の配下でしか利用できませんが、3の記述を利用することで、< % … % > や< % = … % >を跨いだコンテンツをまとめてコメントアウトできます。

　デバッグ時に特定の機能やレイアウトを一時的に無効化したい場合にも利用できるでしょう。

4 < % =begin % > … < % =end % >

　3の構文は確かに便利ですが、問題もあります。というのも、標準的な条件分岐構文をコメントアウトの用途に利用しているため、本来の条件分岐と一見して見分けがつきにくいことがあるのです。

　そのような場合には、< % =begin % > … < % =end % > を利用すると良いでしょう。=begin … =end は主にドキュメンテーションコメントを記述するための構文で、Rubyでも複数行コメントに利用する場合があります。3よりも明確にコメントであることを表現できるというメリットがあります。

　4の構文では、必ず「=begin」「=end」は行頭に記述しなければならない点に注意してください。たとえば、以下のような記述はいずれも不可です。

5 <!-- … -->

　標準的なHTMLのコメントです。ERBはあくまでHTMLをベースとしていますから、当然、HTMLのコメントも利用できます。ただし、1～4と異なり、ブラウザ側で処理されるコメントですので、配下の内容はクライアント側からも見えてしまう点に注意してください。

　エンドユーザが参照する可能性がある情報（サイト管理者の情報など）を記述したり、デバッグ時に出力したHTMLを確認するための目印を埋め込んだりしたい場合に便利です。

■

　次回は「2.4 モデルの基本」を説明します。

• ← 前回
• ▼ この記事の連載 INDEX ▼ 連載 RSS
• 次回 →