先生と生徒の会話形式で理解しよう

生徒

「Railsのビューで条件分岐を書いたり、たくさんの項目を表示するときにループを使いたいんですが、ERBがごちゃごちゃになって読みにくくなってしまいます…。」

先生

「ビューは見た目の設計図なので、可読性がとても大切です。ifやeachをそのまま書くと複雑に見えますが、書き方を工夫すればスッキリさせることができますよ。」

生徒

「可読性を上げるってどういうことですか？読みやすく書く方法があるんですか？」

先生

「もちろんです。ifやeachの整理方法、ヘルパーへの抽出、パーシャルの使い方も紹介しますので安心してください。」

1. ビューにおけるif文とは？条件によって表示内容を切り替える仕組み

Railsのビュー（ERB・Haml・Slim）は、単なるHTMLではなくRubyコードを組み合わせて動的な画面を作るための仕組みです。例えば、ログインしているかどうかで表示するメニューを変えたいとき、あるデータが存在するときだけメッセージを出したいときなどにif文が使われます。

if文はRubyの基本構文ですが、ビューの中では「必要なときだけ表示する」という役割で活躍します。初心者のうちは、ERBタグの<% %>と<%= %>の違いに注意することが大切です。


<% if @user.present? %>
  <p><%= @user.name %>さん、ようこそ！</p>
<% end %>

このように、条件が成立した場合だけHTMLが表示されます。ビューの条件分岐は最小限にしつつ整理して書くことで、可読性が高まりメンテナンスしやすいテンプレートになります。

2. ループ（each）とは？複数データをきれいに表示する基本

RailsではActiveRecordで取得したデータを一覧表示することがよくあります。その際、eachを使うことで1件ずつ繰り返して整った形式で画面に表示できます。


<% @users.each do |user| %>
  <p><%= user.name %></p>
<% end %>

このようにeachを使うと、ユーザー一覧や商品一覧など、複数のデータをまとめて出力できます。ERBだけでなく、HamlやSlimでも同じような構造で記述できます。ビューでループを書くときは、インデント（字下げ）をそろえることが可読性を上げるポイントです。

動的な画面を作ろうとするとif文やeach文が増えていきます。特にERBではRubyコードとHTMLが混ざるため、行数が増えると読みにくくなってしまいます。例えば小さな条件でもifを何度も繰り返すと、初心者はどこからどこまでが条件なのか分からなくなることがあります。

ビューは画面の見た目を決める場所なので、不要なRubyコードはできるだけ外に追い出すことが大切です。これを実現するための仕組みが「ヘルパー」と「パーシャル」です。

if文の可読性を上げるためには、なるべく短くスッキリと書くことが大切です。ビューでは、あまり複雑な条件式をそのまま書かず、シンプルな形に整理することがポイントです。


<% return unless @user.present? %>
<p><%= @user.name %></p>

また、否定条件（if !condition）のような読みづらい形より、肯定条件を優先すると理解しやすくなります。初心者ほど読みやすい記述にすることで、後の見直しが簡単になります。

eachの中が長くなると、ビューの中に大量のHTMLが並んで読みにくくなってしまいます。この問題を解決するために、Railsではパーシャルという仕組みを使います。パーシャルとは、小さなテンプレートを別ファイルに切り離す方法です。


<!-- users/index.html.erb -->
<% @users.each do |user| %>
  <%= render "user", user: user %>
<% end %>


<!-- users/_user.html.erb -->
<p><%= user.name %></p>

このように分割すると、each内の処理が一行だけになり、読みやすさが大幅に向上します。ビューを整理する習慣は、Rails開発で特に重要です。

ビューの中で長い条件式を書くのではなく、ヘルパーに移動して短いメソッドとしてまとめる方法があります。これにより、コードの意味が明確になり、ロジックをビューから切り離せます。


# app/helpers/users_helper.rb
def display_name(user)
  user.admin? ? "管理者：#{user.name}" : user.name
end


<%= display_name(user) %>

このようにヘルパーに抽出すると、ビューがすっきりして、ERB・Haml・Slimなどテンプレートエンジンに関係なく読みやすく統一できるメリットがあります。

パーシャルとヘルパーを組み合わせると、ビューの可読性はさらに高くなります。ループ自体はindexページに残し、表示内容はパーシャルに、条件分岐はヘルパーにまとめる、という役割分担が理想です。


<!-- posts/index.html.erb -->
<% @posts.each do |post| %>
  <%= render "post", post: post %>
<% end %>


<!-- posts/_post.html.erb -->
<h3><%= formatted_title(post) %></h3>


# app/helpers/posts_helper.rb
def formatted_title(post)
  post.published? ? post.title : "下書き（非公開）"
end

このようにファイルごとに役割が明確になると、ERBやHamlの経験が浅くても迷わずにコードを追えるようになります。Railsらしいシンプルで読みやすいテンプレートを作るために、とても役立つ考え方です。

Railsではレイアウトを使うことで画面全体の枠組みを共通化できます。各ビューでは必要な部分だけを表示し、ヘッダーやフッターなどの共通要素はレイアウトで管理します。if文やeachをレイアウトに書きすぎると読みにくくなるため、必要最小限にすることが大切です。

パーシャルとレイアウトを組み合わせることで、ビュー全体が自然に整理され、複雑なRubyコードが画面に混ざらずに済むため、初心者でも迷わない構造になります。