ActionView::Helpers::TextHelper

simple_format

API ドキュメント（Rails 8.1.4.1） ↗
def simple_format(text, html_options = {}, options = {})

説明

文字列を、段落ごとの <p> と、改行の <br /> にして返します。

引数

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

空行（改行が 2 つ以上続くところ）で区切って、それぞれを <p> で囲みます。1 つだけの改行の後ろには、<br /> を追加します。options の sanitize を渡さないときは、sanitize で <script> などを消してから囲みます（<b> は残します）。文字列が空（か空白だけ、nil）なら、中身のない <p></p> を返します。
html_options= {}
ヘルパー共通の options

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

すべてのヘルパー共通

{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 以外のキーを空白でつなぎます。
ここにない html_options は、どの <p> にも付く HTML 属性になります。値が nil なら、その HTML 属性は追加しません。
options= {}
"div"
段落を、<p> の代わりに渡した名前の要素で囲みます。
false にすると、sanitize せずに、渡した文字列をそのまま囲みます（<script> も残ります）。
ここにない options のうち、sanitize_options は sanitize に渡す options です。ほかは使いません。

ERB

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


          

        


        

          

            
HTML

          

          

            
            

          

        


        

          

            
プレビュー