form_for(record, options={}, &block)
http://api.rubyonrails.org/ の form_for 自分用メモ
record
モデル名のstringかsymbol or モデルオブジェクトを受け取る
recordのルーティングが config/routes.rb内でresourcesメソッドを使ってRESTfulに設定してあると、urlを明示しなくてもRailsが良きように解釈してくれる。
recordのルーティング設定で namespace が使われている場合(ex. 名前付きルートがadmin_user_path)はこうする
form_for [:admin, @user] do |f|
recordに関連が定義されているオブジェクトがある場合、こうする
form_for [@document, @comment] do |f|
と、新規作成時にちゃんと @documentに紐づく@commentが作られる。
モデルオブジェクトを渡した時の違い
-
input要素のname属性に、渡されたモデルオブジェクトのクラス名を判断して入れてくれる。（変更したい場合はasオプションを使う） - 渡されたオブジェクトが持っている属性の値をつかって初期値を表示する。（-> 永続化されていないオブジェクトでも初期値が表示できるってことかな？）
options
url
フォームのsubmit先
url_forやlink_toに渡せる値なら受け取れるため、名前付きルートを指定することができる。
recordに渡されたものがstringかsymbolでurlオプションが指定されていない場合は現在のurlにフォームは送信される
namespace
設定された値をフォームの要素のid属性に接頭語として使うことで、フォームごとにユニークなものにする。
form_for @person, namespace: :hoge do |f|
= f.text_field :name # <input type="text" id="hoge_person_name" name="person[name]">
method
フォーム送信時のメソッド。たいていgetかpostだが、delete``patch``putなどが指定された場合は、type="hidden" name="_method"のinput要素が追加される
remote
trueにセットされることでsubmitの挙動をUnobtrusive JavaScript driversでコントロールすることができる。
用語：
Unobtrusive JavaScript https://en.wikipedia.org/wiki/Unobtrusive_JavaScript
html
formタグにつけたいhtmlの属性を設定できる
data属性に関しては、htmlオプションを使わずにそのまま書ける。
form_for @person, data: {hoge: "hoge"}
authenticity_token
カスタムのauthenticity_tokenを使いたい時やauthenticity_tokenが必要ない時に設定
enforce_utf8
falseにセットすると、type="hidden" name="utf8"というinput要素が追加されなくなる
（IE8までのブラウザ向けにパラメータをUnicodeでエンコードするためのものらしい。
https://stackoverflow.com/questions/3222013/what-is-the-snowman-param-in-ruby-on-rails-3-forms-for/3348524#3348524）