select_tag

name

:plan

"user[plan]"

<select> の name 属性と id 属性の値にします。id 属性の値は、[ と空白などを _ にし、] を消した形です。

option_tags

options_for_select(%w[basic pro team], "pro")

raw("<option>basic</option><option>pro</option>")

"<option>basic</option><option>pro</option>"

nil

<select> の中身にします。options_for_select などが返した文字列は、そのまま <option> になります。html_safe でない文字列（"<option>…" など）を渡すと、エスケープして出力します。ただ、include_blank（true か文字列）か prompt も渡すと、エスケープせずにそのまま出力します。nil を渡すと、中身は空です。

options= {}

:multiple = nil

truefalse

true にすると、multiple 属性を追加し、name 属性の値の最後に [] を追加します。name が [] で終わるときは、追加しません。

:include_blank = nil

truefalse

true にすると、先頭に value が空の <option> を追加します。文字列を渡すと、その文字列をテキストにします。

:prompt = nil

"Select a plan"

渡した文字列をテキストにして、先頭に value が空の <option> を追加します。true を渡すと、テキストは true になります。

ヘルパー共通の options

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

フォームヘルパー共通

:name = 自動で作る

"q"

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

:id = 自動で作る

nil

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

すべてのヘルパー共通

:disabled

truefalse

true にすると disabled="disabled" を追加し、false にすると追加しません。readonly、required、autofocus など、Rails が持っている一覧（BOOLEAN_ATTRIBUTES）にある HTML 属性はどれも同じで、値が false と nil 以外なら 属性名="属性名" の形で追加します。

:class

{active: true, hidden: false}

Hash を渡すと、値が false と nil 以外のキーを空白でつなぎます。配列を渡すと、nil、false、空の文字列（空白だけの文字列も）を外して、空白でつなぎます。

:data

{controller: "tags", tags_suggestions_value: ["ruby", "rails"]}

Hash を渡すと、キーの _ を - にして、data-* 属性を追加します。値に配列や Hash を渡すと、JSON の文字列にします。

:aria

{describedby: ["name_help", "name_error"], invalid: false}

:data と同じく、aria-* 属性を追加します。値が配列なら、nil と空の文字列を外して、空白でつなぎます（何も残らなければ、追加しません）。値が Hash なら、値が false と nil 以外のキーを空白でつなぎます。

:autocomplete

["section-user", "name"]

配列を渡すと、要素を空白でつないで autocomplete 属性の値にします。

ここにない options は、<select> の HTML 属性になります。値が nil なら、その HTML 属性は追加しません。

select_tag

説明

引数

フォームヘルパー共通

すべてのヘルパー共通

ERB

HTML

プレビュー

フォーム送信