class ActionView::Helpers::FormBuilder

Родительский класс:: Object
Включенные модули:: ActionView::ModelNaming

Объект 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

Приведённый выше код создаёт новый метод 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 1228
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 1240
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) Показать исходный код

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

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

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

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

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

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

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

Примеры

button("Create a 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>

# File actionview/lib/action_view/helpers/form_helper.rb, line 1793
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

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

Возвращает тег флажка, предназначенный для доступа к указанному атрибуту (определяется method) объекта, назначенного шаблону (определяется object). Этот объект должен быть объектом экземпляра (@object), а не локальным объектом. Предполагается, что method возвращает целое число, и если это целое число больше нуля, флажок установлен. Дополнительные параметры тега input могут быть переданы в виде хеша с 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("post", "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("puppy", "gooddog", {}, "yes", "no")
# => <input name="puppy[gooddog]" type="hidden" value="no" />
#    <input type="checkbox" id="puppy_gooddog" name="puppy[gooddog]" value="yes" />

check_box("eula", "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" />

# File actionview/lib/action_view/helpers/form_helper.rb, line 1644
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

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

Оборачивает 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 %>