ActionView::Helpers::TagHelper

content_tag

API ドキュメント（Rails 8.1.4.1） ↗
def content_tag(name, content_or_options_with_block = nil, options = nil, escape = true, &block)

説明

名前を渡した要素を作ります。

引数

値を変えると、ERB と HTML が変わります。

要素の名前にします。Symbol でも文字列でもかまいません。tag と違い、空要素や SVG の要素も、ふつうの要素と同じように作ります。
  • :textarea：tag と同じく、中身の前に改行を足します。
  • :br などの空要素：終了タグも付けます。
  • :circle などの SVG の要素：中身がなくても、終了タグを付けます。
  • :my_element：_ を - にしません。- の付いた名前にするには、文字列の "my-element" を渡します。
空白などを含む名前を渡すと、ArgumentError になります。
= nil
要素の中身にします。中身はエスケープします。ブロックを渡さないときは、Hash を渡しても options として扱わず、Hash を文字列にしたものを中身にします。
options= {}
ヘルパー共通の options

Rails はどのヘルパーでも、これらの options を同じように処理します。HTML の仕様で <div> に使えないものや、使う場面が少ないとこのサイトで判断したものは、ここでは省いています。

すべてのヘルパー共通

true にすると disabled="disabled" を追加し、false にすると追加しません。readonly、required、autofocus など、Rails が持っている一覧（BOOLEAN_ATTRIBUTES）にある HTML 属性はどれも同じで、値が false と nil 以外なら 属性名="属性名" の形で追加します。
{active: true, hidden: false}
Hash を渡すと、値が false と nil 以外のキーを空白でつなぎます。配列を渡すと、nil、false、空の文字列（空白だけの文字列も）を外して、空白でつなぎます。
{controller: "tags", tags_suggestions_value: ["ruby", "rails"]}
Hash を渡すと、キーの _ を - にして、data-* 属性を追加します。値に配列や Hash を渡すと、JSON の文字列にします。
{describedby: ["name_help", "name_error"], invalid: false}
:data と同じく、aria-* 属性を追加します。値が配列なら、nil と空の文字列を外して、空白でつなぎます（何も残らなければ、追加しません）。値が Hash なら、値が false と nil 以外のキーを空白でつなぎます。
["section-user", "name"]
配列を渡すと、要素を空白でつないで autocomplete 属性の値にします。
/[a-z]+/i
正規表現を渡すと、/ と / の間の部分を pattern 属性の値にします。i などのフラグは、値に入りません。
ここにない options は、<div> の HTML 属性になります。値が nil なら、その HTML 属性は追加しません。
= true 
false
false にすると、中身と HTML 属性の値をエスケープしません。HTML 属性の値の " だけは、&quot; にします。
&block= nil
ブロックを渡すと、ブロックの出力を中身にします。このときは、2 つ目の引数の content_or_options_with_block に Hash を渡すと options として扱い（3 つ目の引数の options は使いません）、それ以外を渡すと使いません。

ERB

直前との違い： 追加 削除 変更


          

        


        

          

            
HTML

          

          

            
            

          

        


        

          

            
プレビュー