ActionView::Helpers::FormOptionsHelper

select

API ドキュメント（Rails 8.1.4.1） ↗
def select(object, method, choices = nil, options = {}, html_options = {}, &block)

説明

モデルの属性に紐づく <select> と、その中の <option> を作ります。

引数

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

object:user
method:plan
<option> のテキストと value 属性の値にします。渡すものによって、次のように変わります。
  • 文字列の配列：テキストと value が同じになります。
  • [テキスト, value] の組の配列か、Hash（テキスト => value）：テキストと value を分けます。
  • 組の 3 つ目に Hash を入れる：その <option> の HTML 属性になります。
  • 値が配列の Hash（グループの名前 => 選択肢）か、[グループの名前, 選択肢] の組の配列：<optgroup> に分けます。組の 3 つ目に Hash を入れると、その <optgroup> の HTML 属性になります。
  • html_safe の文字列（options_for_select などの出力）：そのまま <select> の中身にします。このときは、オブジェクトの値で selected を追加しません。
オブジェクトの値と同じ value の <option> に、selected を追加します。nil を渡すとNoMethodError になります。オブジェクトの値が nil なら、value が空の <option> に selected を追加します。
options= {}
"team"
オブジェクトの値の代わりに、渡した値（配列なら、そのどれか）と同じ value の <option> に selected を追加します。
["team"]
渡した値（配列なら、そのどれか）と同じ value の <option> に、disabled を追加します。
true にすると、先頭に value が空の <option> を追加します。文字列を渡すと、その文字列をテキストにします。html_options の required が true のときに false を渡すと、ArgumentError になります。html_options の multiple が true か size が 1 でないときは、エラーになりません。
true にすると、オブジェクトの値（options の selected を渡したときはその値）がないときだけ、先頭に value が空の <option> を追加します。テキストは helpers.select.prompt の訳か、なければ Please select です。文字列を渡すと、その文字列をテキストにします。
false にすると、html_options の multiple が true のときに追加する、value が空の hidden の <input> を追加しません。
ここにない options は使いません。required、multiple、size だけは html_options に移して、<select> の HTML 属性にします。
html_options= {}
true にすると、multiple 属性を追加し、name 属性の値の最後に [] を追加します。<select> の前に、value が空の hidden の <input> も追加します。
true にすると、required 属性を追加し、options の include_blank を渡さなくても先頭に value が空の <option> を追加します。options の prompt に真の値を渡したときと、html_options の multiple が true か size が 1 でないときは、追加しません。
ヘルパー共通の options

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

フォームヘルパー共通

"q"
自動で作る name 属性の値の代わりに、渡した値を使います。nil を渡すと、name 属性を追加しません。
nil
自動で作る id 属性の値の代わりに、渡した値を使います。nil を渡すと、id 属性を追加しません。

すべてのヘルパー共通

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 属性の値にします。
ここにない html_options は、<select> の HTML 属性になります。値が nil なら、その HTML 属性は追加しません。

ERB

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


          

        


        

          

            
HTML

          

          

            
            

          

        


        

          

            
プレビュー

            

              
              
                
プレビューを操作すると、フォーム送信の内容が変わります。


            

          


          

            
フォーム送信

            

              
フォームデータ

              

                
namevalue

                
              

              

                リクエストボディを見る
                
Content-Type：

                

              

              

                
params