icon
icon

Ruby on Railsでエラーメッセージを表示する方法【初心者向け】

初心者向けにRuby on Railsでエラーメッセージを表示させる方法について解説しています。バリデーションの定義やエラーメッセージの日本語化など実際に業務でも使える知識を身につけることができるので、ぜひご覧ください。

テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元:GMOリサーチ株式会社 調査期間:2021年8月12日~8月16日  調査対象:2020年8月以降にプログラミングスクールを受講した18~80歳の男女1,000名  調査手法:インターネット調査

RubyのフレームワークのRuby on Railsでモデルを作成していると、空白のユーザーは登録できないようにしたり、パスワードの長さを制限したりといったロジックが必要になってきます。

そのロジックを簡単に実装することができる機能がバリデーションです。

今回はそんなバリデーションについてと、そのバリデーションに違反した時に表示されるエラーメッセージについて、テックアカデミーのメンター(現役エンジニア)が実際のコードを使用して初心者向けに解説します。

目次

1時間でできる無料体験!

Rubyについてそもそもよく分からないという方は、Rubyとは何なのか解説した記事を読むとさらに理解が深まります。

 

大石ゆかり

田島メンター!!例えばユーザーが必要な項目の部分を空白の状態で送信した場合、それに対してエラーメッセージを表示させるということは可能なんでしょうか?

田島悠介

そういうときはバリデーションを使って、結果によってメッセージを表示させるようにするといいよ。

大石ゆかり

バリデーションというのは何ですか〜?

田島悠介

ある値が特定の条件を満たしているかというのをチェックすることだよ。例えばこういう書き方をしてみよう。

 

バリデーションの定義

バリデーションはモデル内で定義します。

以下のように書くと、nameかemailを空白で登録した際は、登録できないようにするバリデーションを追加できます。

class User < ApplicationRecord
  validates :name, presence: true
  validates :email, presence: true
end

バリデーションはこの他にも、最大文字、最小文字、正規表現などで作成できます。

 

大石ゆかり

このpresenceというのは何ですか?

田島悠介

presenceは英語で存在という意味で、その名の通り空でない状態だとtrueとなるよ。

大石ゆかり

なるほど、だから”name”や”email”が空白であるかどうかということを検証することになるんですね。

田島悠介

では次に、エラーメッセージの設定をしていこう。

 

エラーメッセージの表示

エラーメッセージはエラーが発生すると、errors.full_message内に格納されます。

Userモデルの場合、以下のように書くとエラーメッセージを表示できます。

<% if @user.errors.any? %>
  <div id="error_explanation" class="alert alert-danger">
    <ul>
      <% @user.errors.full_messages.each do |message| %>
        <li><%= message %></li>
      <% end %>
    </ul>
  </div>
<% end %>

 

まず@userのエラーがあるか確認します。

あった場合、@user.errors.full_messagesをすべて出力します。

 

[PR] Rubyのプログラミングで挫折しない学習方法を動画で公開中

エラーメッセージの日本語化

Ruby on Railsで出力されるエラーメッセージは、デフォルトでは英語になっています。

そのため、そのままだとWebアプリケーションを利用するユーザーにとって、とても不親切な文章になってしまいます。

そこで、エラーメッセージを日本語化する方法について解説していきたいと思います。

日本語化するにはrails-i18nというgemを使用します。

Gem fileに以下を追加し、bundle installしてください。

gem 'rails-i18n'

 

次に、config/application.rb内に以下を追記してください。

config.i18n.default_locale = :ja

 

そのあとサーバを再起動すると、エラーメッセージの一部が日本語化されていると思います。

しかし、今のままだとemailやnameは日本語化されていません。

そこでカラム名を日本語化していきましょう。

config/localesないにja.ymlを追加し、以下を入力してください。

ja:
  activerecord:
    models:
      user: ユーザー
    attributes:
      user:
        name: 名前
        email: メールアドレス

サーバを再起動すると、エラーメッセージが完全に日本語化されていることがわかります。

 

以上、Railsでエラーメッセージを表示する方法について解説しました。

 

田島悠介

今回の場合だと、app/models内の「application_record.rb」ファイルでバリデーションを設定、app/views/user/内の「edit.html.erb」にエラーメッセージへの処理を追加という形になるね。

大石ゆかり

試しに名前を空白で入力してみたら、エラーメッセージが表示されました!

田島悠介

エラー画面に改めて項目を入力する欄が表示されるので、該当のデータを入力すればそこから登録もできるよ。実際にやってみよう。

大石ゆかり

分かりました、ありがとうございます!

 

コラム

コスパとタイパ、両方結果的に良くなる良くなる学び方とは?

「スクールは高いし時間も縛られて効率が悪い」と考える方は多いと思います。
もちろん、時間も費用もかかることは間違いありません。
ただ 結果的に無駄な学びにお金も時間もかける方がリスクが高いという考えもあります。

コスパ・タイパ最適化の参考として、 テックアカデミー卒業生がスクールを選んだ理由 をご紹介します。

  • ・困ったときに、質問や相談できる相手がいるため挫折しなかった
  • ・プロとして必要なスキルのみを深く学べたので無駄がなかった
  • ・副業案件の提供と納品までのサポートがあったので目的を達成できた

安価・短期間で広く浅く学んでも意味がありません。 本当に自分の目的が達成できるか、それが重要です。
自分にどのスキルや学び方が合っているか、どんな学習方法かなど、お気軽に 無料相談 に参加してみませんか?

カウンセラー・現役のプロへ、何でも気軽に無料相談可能。 30分か60分お好きな時間が選べて、かつ3回まで すべて無料で ご利用できます。
無理な勧誘は一切ない ので、お気軽にご参加ください。

今なら相談した方限定の割引・参加特典付き! 無料相談はこちら

Ruby on Railsを学習中の方へ

これで解説は終了です、お疲れさまでした。

  • つまずかず「効率的に」学びたい
  • 副業や転職後の「現場で使える」知識やスキルを身につけたい

プログラミングを学習していて、このように思ったことはありませんか?

テックアカデミーのWebアプリケーションコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。

合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、Ruby on Railsを使ったWebアプリケーション開発を学べます。

まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。

時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします!

初心者・未経験でもできる。まずはテックアカデミーに相談しよう

プログラミングを独学で学習していて、このように感じた経験はないでしょうか?

  • ・調べてもほしい情報が見つからない
  • ・独学のスキルが実際の業務で通用するのか不安
  • ・目標への学習プランがわからず、迷子になりそう

テックアカデミーでは、このような 学習に不安を抱えている方へ、マンツーマンで相談できる機会を無料で提供 しています。
30分間、オンラインでどんなことでも質問し放題です。

「受けてよかった」と感じていただけるよう カウンセラーやエンジニア・デザイナー があなたの相談に真摯に向き合います。

「自分に合っているか診断してほしい」
「漠然としているが話を聞いてみたい」

こんなささいな悩みでも大丈夫です。

無理な勧誘は一切ありません ので、まずはお気軽にご参加ください。
※体験用のカリキュラムも無料で配布いたします。(1週間限定)

今なら参加者限定の割引特典付き! 無料相談を予約する