tag类的Helper
form_tag
<%= form_tag("/search", method: "get") do %>
<%= label_tag(:q, "Search for:") %>
<%= text_field_tag(:q) %>
<%= submit_tag("Search") %>
<% end %>
#生成HTML如下
<form accept-charset="UTF-8" action="/search" method="get">
<label for="q">Search for:</label>
<input id="q" name="q" type="text" />
<input name="commit" type="submit" value="Search" />
</form>
#生成的表单的每个input属性都有ID属性,其值和name属性的值是一样的
form_tag({controller: "people", action: "search"}, method: "get", class: "nifty_form")
#第二个hash参数为html属性
<form accept-charset="UTF-8" action="/people/search" method="get" class="nifty_form">
复选框
<%= check_box_tag(:pet_dog, "12") %>
<input id="pet_dog" name="pet_dog" type="checkbox" value="12" />
单选框
<%= radio_button_tag(:age, "child") %>
<input id="age_child" name="age" type="radio" value="child" />
处理模型对象
#如果控制器定义了@person实例变量,有属性name ="Henry"
<%= text_field(:person, :name) %>
#生成如下
<input id="person_name" name="person[name]" type="text" value="Hery" />
#params获取的值为
{'person' => {'name' => 'Henry'}}
#可以使用params[:person][:name]获取提交的值
#如果@person实例是数据库表nurse_aid_person,那么产生的代码如下
<input id="person_name" name="nurse_aid_person[name]" type="text" value="Hery" />
Hash
#Hash可以随意嵌套
<input id="person_address_city" name="person[address][city]" type="text"
value="New York"/>
#获取的params为
{'person'=>{'address'=>{'city'=>'New York'}}}
params[:person][:address][:city]
数组
#一般情况下Rails回忽略重复的参数名
<input name="person[phone_number][]" type="text"/>
<input name="person[phone_number][]" type="text"/>
<input name="person[phone_number][]" type="text"/>
#params[:person][:phone_number]是一个数组
Hash和数组结合
<input name="addresses[][line1]" type="text"/>
<input name="addresses[][line2]" type="text"/>
<input name="addresses[][city]" type="text"/>
#params[:addresses]值是一个由Hash组成的数组
form_for表单绑定对象
<%= form_for @article, url: {action: "create"}, html: {class: "nifty_form"} do |f| %>
<%= f.text_field :title %>
<%= f.text_area :body, size: "60x12" %>
<%= f.submit "Create" %>
<% end %>
<form action="/articles/create" method="post" class="nifty_form">
<input id="article_title" name="article[title]" type="text" />
<textarea id="article_body" name="article[body]" cols="60" rows="12"></textarea>
<input name="commit" type="submit" value="Create">
</form>
fields_for方法
#同一表单中编辑多个模型对象时经常使用fields_for方法。
#eg、有个Person模型,和ContactDetail模型关联
<%= form_for @person, url: {action: "create"} do |person_form| %>
<%= person_form.text_field :name %>
<%= fields_for @person.contact_detail do |contact_details_form| %>
<%= contact_details_form.text_field :phone_number %>
<% end %>
<% end %>
#生成的HTML代码如下
<form action="/people/create" class="new_person" id="new_person" method="post">
<input id="person_name" name="person[name]" type="text" />
<input id="contact_detail_phone_number" name="contact_detail[phone_number]" type="text" />
</form>
命名空间
#admin命名空间
form_for [:admin, @article] #admin_article_path(@article)
form_for[:admin, :management, @article]
文件处理
上传文件
#params[:picture]
<%= form_tag({action: :upload}, multipart: true) do %>
<%= file_field_tag 'picture' %>
<% end %>
#params[:person][:picture]
<%= form_for @person do |f| %>
<%= f.file_field :picture %>
<% end %>
处理上传
#可以使用CarrierWave和Paperclip等第三方库
def upload
upload_io = params[:person][:picture]
File.open(Rails.root.join('public', uploads, upload_io.original_filename), 'wb') do |file|
file.write(uploaded_io.read)
end
end
使用Ajax上传文件
<%= form_for @person, builder: LabellingFormBuilder do |f| %>
<%= f.text_field :first_name %>
<% end %>
#定制表单构造器
class LabellingFormBuilder < ActionView::Helpers::FormBuilder
def text_field(attribute, options=[])
label(attribute) + super
end
end
外部资源
#如果不需要access_token的话,可以关闭,如果需要,设置authenticity_token的值
<%= form_tag 'http://www.baidu.com', authenticity_token: false do %>
...
<% end %>
复杂的表单
class Person < ActiveRecord::Base
has_many :addresses
accepts_nested_attributes_for :addresses, allow_destroy: true,
reject_if: lambda{|attributes| attributes['kind'].blank?}
#自动为Person对象创建address_attributes=方法,用于创建、更新、删除地址操作
end
class Address < ActiveRecord::Base
belongs_to :person
end
嵌套表单
<%= form_for @person do |f| %>
Addresses:
<ul>
<%= fields_for @person.addresses do |addresses_form| %>
<li>
<%= addresses_form.label :kind %>
<%= addresses_form.text_field :kind %>
<%= addresses_form.label :street %>
<%= addresses_form.text_field :street %>
</li>
<% end %>
</ul>
<% end %>
如果关联支持嵌套属性,fields_for方法会为关联中的每个元素执行一遍代码块,如果没有Address,就不执行,一般做法是在控制器中构建一个或者多个空的子属性。这样至少会有一组字段显示出来。
def new
@person = Person.new
2.times { @person.addresses.build }
end
如果用户提交了两个地址,提交的参数如下
{
'person' => {
'name' => 'John Doe',
'addresses_attributes' => {
'0' => {
'kind' => 'Home',
'street' => '221b Baker Street'
},
'1' => {
'kind' => 'Office',
'street' => '31 Spooner Street'
}
}
}
}
控制器端
def create
@person = Person.new(person_params)
end
private
def person_params
params.require(:person).permit(:name, addresses_attributes:[:id, :kind, :street])
end
删除属性
#表单
<%= form_for @person do |f| %>
Addresses:
<ul>
<%= f.fields_for :addresses do |addresses_form| %>
<li>
#如果属性组成的hash中包含_destroy键,且值为1或true,就会删除对象
<%= addresses_form.check_box :_destroy%>
<%= addresses_form.label :kind %>
<%= addresses_form.text_field :kind %>
...
</li>
<% end %>
</ul>
<% end %>
修改控制器中的参数白名单
def person_params
params.require(:person).
permit(:name, addresses_attributes: [:id, :kind, :street, :_destroy])
end