класс ActionView::Helpers::FormBuilder

Родитель:: Object

Объект FormBuilder связан с конкретным объектом модели и позволяет генерировать поля, связанные с объектом модели. Объект FormBuilder передаётся в качестве результата при использовании form_for или fields_for. Например:

<%= form_for @person do |person_form| %>
  Name: <%= person_form.text_field :name %>
  Admin: <%= person_form.check_box :admin %>
<% end %>

В этом блоке объект FormBuilder передаётся в качестве переменной person_form. Это позволяет генерировать поля text_field и check_box путём указания одноимённых методов, которые изменяют базовый шаблон и связывают объект модели +@person+ с формой.

Объект FormBuilder можно рассматривать как прокси для методов в модуле FormHelper. Однако этот класс позволяет вызывать методы с объектом модели, для которого вы создаёте форму.

Вы можете создавать собственные настраиваемые шаблоны FormBuilder, наследуя от этого класса. Например:

class MyFormBuilder < ActionView::Helpers::FormBuilder
  def div_radio_button(method, tag_value, options = {})
    @template.content_tag(:div,
      @template.radio_button(
        @object_name, method, tag_value, objectify_options(options)
      )
    )
  end
end

Этот код создаёт новый метод div_radio_button, который оборачивает новый радио-кнопку в div. Обратите внимание, что при передаче опций необходимо вызвать objectify_options, чтобы объект модели был правильно передан в метод. Если objectify_options не вызывается, то новый созданный помощник не будет связан с моделью.

Теперь код div_radio_button из примера можно использовать следующим образом:

<%= form_for @person, :builder => MyFormBuilder do |f| %>
  I am a child: <%= f.div_radio_button(:admin, "child") %>
  I am an adult: <%= f.div_radio_button(:admin, "adult") %>
<% end -%>

Стандартный набор методов помощников для построения форм находится в классе-атрибуте field_helpers.

Атрибуты

index[R]

multipart[R]

multipart?[R]

object[RW]

object_name[RW]

options[RW]

Публичные методы класса

_to_partial_path() Показать исходный код

# File actionview/lib/action_view/helpers/form_helper.rb, line 1272
def self._to_partial_path
  @_to_partial_path ||= name.demodulize.underscore.sub!(/_builder$/, '')
end

new(object_name, object, template, options) Показать исходный код

# File actionview/lib/action_view/helpers/form_helper.rb, line 1284
def initialize(object_name, object, template, options)
  @nested_child_index = {}
  @object_name, @object, @template, @options = object_name, object, template, options
  @default_options = @options ? @options.slice(:index, :namespace) : {}
  if @object_name.to_s.match(/\[\]$/)
    if object ||= @template.instance_variable_get("@#{Regexp.last_match.pre_match}") and object.respond_to?(:to_param)
      @auto_index = object.to_param
    else
      raise ArgumentError, "object[] naming but object param and @object var don't exist or don't respond to to_param: #{object.inspect}"
    end
  end
  @multipart = nil
  @index = options[:index] || options[:child_index]
end

Публичные методы экземпляра

button(value = nil, options = {}, &block) Показать исходный код

# File actionview/lib/action_view/helpers/form_helper.rb, line 1856
def button(value = nil, options = {}, &block)
  value, options = nil, value if value.is_a?(Hash)
  value ||= submit_default_value
  @template.button_tag(value, options, &block)
end

Добавляет кнопку отправки для данной формы. При отсутствии значения проверяется, является ли объект новым ресурсом, чтобы создать правильную метку:

<%= form_for @post do |f| %>
  <%= f.button %>
<% end %>

В примере выше, если @post — новый объект, будет использована метка «Создать пост», в противном случае — «Обновить пост».

Эти метки можно настроить с помощью I18n, в ключе helpers.submit (так же как и помощник submit) и принять %{model} как интерполяцию перевода:

en:
  helpers:
    submit:
      create: "Create a %{model}"
      update: "Confirm changes to %{model}"

Также ищется ключ, специфичный для данного объекта:

en:
  helpers:
    submit:
      post:
        create: "Add %{model}"

Примеры

button("Create post")
# => <button name='button' type='submit'>Create post</button>

button do
  content_tag(:strong, 'Ask me!')
end
# => <button name='button' type='submit'>
#      <strong>Ask me!</strong>
#    </button>

check_box(method, options = {}, checked_value = "1", unchecked_value = "0") Показать исходный код

# File actionview/lib/action_view/helpers/form_helper.rb, line 1698
def check_box(method, options = {}, checked_value = "1", unchecked_value = "0")
  @template.check_box(@object_name, method, objectify_options(options), checked_value, unchecked_value)
end

Возвращает тег чекбокса, настроенный для доступа к заданному атрибуту (определяемому method) объекта, присвоенного шаблону (определяемому object). Этот объект должен быть объектом экземпляра (@object), а не локальным объектом. Ожидается, что method вернёт целое число, и если это целое число больше нуля, то чекбокс будет отмечен. Дополнительные параметры тега ввода могут быть переданы как хеш с options. Значение checked_value по умолчанию равно 1, а значение unchecked_value по умолчанию равно 0, что удобно для булевых значений.

Особенность

Спецификация HTML гласит, что неотмеченные чекбоксы не успешны, и поэтому веб-браузеры их не отправляют. К сожалению, это создаёт особенность: если у модели Invoice есть флаг paid, и в форме, которая редактирует платёжный счёт, пользователь снимает его галочку, параметр paid не отправляется. Поэтому любое выражение массовой присваивания, такое как

@invoice.update(params[:invoice])

не обновит флаг.

Чтобы предотвратить это, помощник генерирует вспомогательное скрытое поле перед самим чекбоксом. Скрытое поле имеет то же имя, а его атрибуты имитируют неотмеченный чекбокс.

Таким образом, клиент отправляет либо только скрытое поле (представляющее, что чекбокс не отмечен), либо оба поля. Поскольку спецификация HTML гласит, что пары ключ/значение должны отправляться в том же порядке, в котором они появляются в форме, а извлечение параметров получает последнее вхождение любого повторяющегося ключа в строке запроса, это работает для обычных форм.

К сожалению, это решение не работает, когда чекбокс попадает в массив-подобный параметр, как в

<%= fields_for "project[invoice_attributes][]", invoice, index: nil do |form| %>
  <%= form.check_box :paid %>
  ...
<% end %>

потому что повторение имён параметров именно то, что Rails пытается отличить элементы массива. Для каждого элемента с отмеченным чекбоксом вы получаете дополнительный элемент-призрак с только этим атрибутом, присвоенным «0».

В этом случае предпочтительнее использовать check_box_tag или использовать хеши вместо массивов.

# Let's say that @post.validated? is 1:
check_box("validated")
# => <input name="post[validated]" type="hidden" value="0" />
#    <input checked="checked" type="checkbox" id="post_validated" name="post[validated]" value="1" />

# Let's say that @puppy.gooddog is "no":
check_box("gooddog", {}, "yes", "no")
# => <input name="puppy[gooddog]" type="hidden" value="no" />
#    <input type="checkbox" id="puppy_gooddog" name="puppy[gooddog]" value="yes" />

# Let's say that @eula.accepted is "no":
check_box("accepted", { class: 'eula_check' }, "yes", "no")
# => <input name="eula[accepted]" type="hidden" value="no" />
#    <input type="checkbox" class="eula_check" id="eula_accepted" name="eula[accepted]" value="yes" />

collection_check_boxes(method, collection, value_method, text_method, options = {}, html_options = {}, &block) Показать исходный код

# File actionview/lib/action_view/helpers/form_options_helper.rb, line 864
def collection_check_boxes(method, collection, value_method, text_method, options = {}, html_options = {}, &block)
  @template.collection_check_boxes(@object_name, method, collection, value_method, text_method, objectify_options(options), @default_options.merge(html_options), &block)
end

Оборачивает ActionView::Helpers::FormOptionsHelper#collection_check_boxes для билдеров форм:

<%= form_for @post do |f| %>
  <%= f.collection_check_boxes :author_ids, Author.all, :id, :name_with_initial %>
  <%= f.submit %>
<% end %>