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

Родитель:: Объект

Объект 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 1645
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 1657
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, :skip_default_ids, :allow_method_names_outside_object) : {}
  @default_html_options = @default_options.except(:skip_default_ids, :allow_method_names_outside_object)

  convert_to_legacy_options(@options)

  if @object_name.to_s.match(/\[\]$/)
    if (object ||= @template.instance_variable_get("@#{Regexp.last_match.pre_match}")) && 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 2244
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 2086
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 870
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_html_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 %>