組み込みRuby (ERB) 101: Rubyの動的テンプレート作成入門ガイド

2025年3月17日

Rubyの開発者がHTMLテンプレートにダイナミック・ロジックをシームレスに組み込んでいるのを不思議に思ったことはないだろうか。次のように入力します。 組み込みルビー(ERB), ERBは、HTMLに直接Rubyコードを埋め込むことができる強力なテンプレート・エンジンで、動的でデータ駆動型のウェブ・ページの作成を可能にします。シンプルなブログから複雑なウェブ・アプリケーションまで、ERBは次のような用途に欠かせないツールです。 Ruby開発者.

このガイドでは、ERB の構文や設定から実用的な例やベスト・プラクティスまで、ERB の基本について説明します。最後には、RubyプロジェクトでERBを使って動的で保守性の高いテンプレートを作成する方法をしっかりと理解できるようになるでしょう。さっそく始めましょう!

組み込みRuby(ERB)とは?

Embedded Ruby(ERB)は、HTMLファイル内に直接Rubyコードを記述できるテンプレート・システムです。この組み合わせにより、ユーザー固有のデータを表示したり、アイテムのリストを繰り返し表示したりするような動的なコンテンツを生成することが可能になります。ERBファイルの拡張子は通常.erbで、Rubyインタプリタによって処理され、最終的なHTML出力が生成されます。.

ERBはRuby on Railsで広く使われており、ビューをレンダリングするためのデフォルトのテンプレートエンジンとして機能しています。しかし、ERBはRailsに限らず、どのようなRubyプロジェクトでも動的テンプレートを作成するために使用できます。.

ERBの仕組み

ERBでは、RubyコードとHTMLを区別するために特別な区切り文字を使用しています。主な構文を簡単に説明します:

: 何も出力せずにRubyのコードを実行する。.

: erb

<% if user_signed_in?%
<p>お帰りなさい!</p>
<%終了 %

: Rubyのコードを実行し、その結果をテンプレートに埋め込みます。.
: erb

<h1>こんにちは、, <%= @user.name %>!</h1>

:レンダリング時に無視されるコメントを追加する。.
: erb

<%# これはコメントであり、出力には表示されません。

これらの区切り文字を使うことで、RubyのロジックとHTMLを混在させることができ、テンプレートをダイナミックで柔軟なものにすることができます。.

RubyプロジェクトでERBを設定する

スタンドアロンRubyスクリプトでERBを使うのは簡単だ。ここでは、その方法を紹介する:

erbライブラリを必要とする:
ルビー

require 'erb'

ERBテンプレートを作成する:
エルブ


<h1>ようこそ、, &lt;%=@ネーム %!</h1>

データをテンプレートにバインドしてレンダリングする:
ルビー

名前 = "アリス"
template = ERB.new(File.read('template.erb'))
出力 = template.result(バインディング)
出力を置く

Ruby on Railsでは、ERBはデフォルトで統合されているので、ビューですぐに使い始めることができる。.

ERBの主な特徴

ERBには、強力なテンプレート・エンジンとなるいくつかの機能が備わっている:

  • パーシャル:他のビューに含めることができる再利用可能なテンプレート。.
    例:erb
    をレンダリングする。
  • レイアウト:共有構造(ヘッダーやフッターなど)。.
    例:erb
  • ヘルパー:テンプレート内の複雑なロジックを単純化するRubyメソッド。.
    例:ルビー
    def format_date(date)
    date.strftime("%B %d, %Y")
    終わり
  • HTMLからの脱出:ユーザー入力をサニタイズすることで、XSS攻撃を防ぎます。.
    例:erb
    <%= h(ユーザー入力)

これらの特徴により、ERBは汎用性が高く、幅広いユースケースに適している。.

ERBの一般的な使用例

ERBはこんな場面でよく使われる:

  • ダイナミックなウェブページ: ユーザー入力またはデータベースクエリに基づいてHTMLコンテンツを生成します。.
  • メールテンプレート: 動的データでカスタマイズ可能なメールレイアウトを作成。.
  • 設定ファイル: Rubyロジックを組み込んだ設定ファイルやレポートの構築。.

例えば、Eコマース・アプリケーションで商品リストを生成するためにERBを使うことができる。


    を行う。
  • - $</li
    <%終了 %

きれいなERBテンプレートを書くためのヒント

ERBテンプレートの保守性と効率性を維持するために、以下のベストプラクティスに従ってください:

  • テンプレート内のRubyロジックを最小化する: 複雑なロジックをヘルパーやコントローラに移す。.
  • パーシャルを使う: 大きなテンプレートを、再利用可能な小さなコンポーネントに分割する。.
  • 深い入れ子は避ける: 可読性を高めるために、条件式とループはシンプルに保つ。.
  • ユーザー入力をエスケープする: セキュリティの脆弱性を防ぐために、常にユーザー入力をサニタイズすること。.

例えば

<% if @user.admin?%
<p>管理者ダッシュボード</p>
.
<p>ユーザー・ダッシュボード</p>
<%終了 %

ロジックをヘルパーに移すこともできます。

def dashboard_message(user)
user.admin??"管理者ダッシュボード" : "ユーザーダッシュボード"
終わり

そしてテンプレートをシンプルにする。

<p>。</p>

例シンプルなERBテンプレートの構築

ERBテンプレートの作成とレンダリングの実例を見てみよう:

Rubyスクリプトを定義する。

require 'erb'
アイテム = ['アップル', 'バナナ', 'チェリー']。

ERBテンプレートの作成:erb


    |items.each do |item| %>|item| %

  • <%終了 %

テンプレートのレンダリング:ruby

template = ERB.new(File.read('template.erb'))
putsテンプレート.result(バインディング)

出力は次のようになる。


  • アップル</li
  • バナナ</li
  • チェリー</li

ERBと他のテンプレート・エンジンとの比較

ERBはシンプルで初心者に優しいが、他のテンプレートエンジンは ハムル、スリム、リキッド は異なる利点を提供する:

  • Haml:インデント・ベースの構文を使用し、よりすっきりとした簡潔なテンプレートを実現。.
  • スリム:ハムルに似ているが、ミニマリズムとパフォーマンスに重点を置いている。.
  • リキッド:安全でサンドボックス化されたテンプレート作成のために設計されています(例:Shopify)。.

ERBの強みは、そのシンプルさとRubyとのシームレスな統合にあり、初心者や以下のようなユーザーに最適です。 Rails開発者.

結論

Embedded Ruby (ERB) は、Ruby のロジックと HTML の間のギャップを埋める、パワフルでわかりやすいツールです。動的なウェブページの構築、電子メールテンプレートの作成、設定ファイルの生成など、ERBはあなたのアイデアを実現するために必要な柔軟性とシンプルさを提供します。.

を深く掘り下げていく。 Ruby開発, ERBをマスターすれば、よりダイナミックで保守性が高く、スケーラブルなアプリケーションを作成できるようになる。さあ、今日からERBを試してみませんか?小さなプロジェクトを構築し、いくつかのテンプレートを微調整し、ERBがあなたのワークフローをどのように変えることができるかを見てみましょう。.