Class: ActionView::Helpers::FormBuilder

Inherits:
Object
  • Object
show all
Defined in:
actionpack/lib/action_view/helpers/date_helper.rb,
actionpack/lib/action_view/helpers/form_helper.rb,
actionpack/lib/action_view/helpers/form_options_helper.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(object_name, object, template, options, proc) ⇒ FormBuilder

Returns a new instance of FormBuilder


1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1226

def initialize(object_name, object, template, options, proc)
  @nested_child_index = {}
  @object_name, @object, @template, @options, @proc = object_name, object, template, options, proc
  @parent_builder = options[:parent_builder]
  @default_options = @options ? @options.slice(:index) : {}
  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
end

Instance Attribute Details

#multipartObject Also known as: multipart?

Returns the value of attribute multipart


1210
1211
1212
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1210

def multipart
  @multipart
end

#objectObject

Returns the value of attribute object


1208
1209
1210
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1208

def object
  @object
end

#object_nameObject

Returns the value of attribute object_name


1208
1209
1210
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1208

def object_name
  @object_name
end

#optionsObject

Returns the value of attribute options


1208
1209
1210
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1208

def options
  @options
end

#parent_builderObject (readonly)

Returns the value of attribute parent_builder


1210
1211
1212
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1210

def parent_builder
  @parent_builder
end

Class Method Details

.model_nameObject


1218
1219
1220
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1218

def self.model_name
  @model_name ||= Struct.new(:partial_path).new(name.demodulize.underscore.sub!(/_builder$/, ''))
end

Instance Method Details

#check_box(method, options = {}, checked_value = "1", unchecked_value = "0") ⇒ Object


1283
1284
1285
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1283

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_select(method, collection, value_method, text_method, options = {}, html_options = {}) ⇒ Object


613
614
615
# File 'actionpack/lib/action_view/helpers/form_options_helper.rb', line 613

def collection_select(method, collection, value_method, text_method, options = {}, html_options = {})
  @template.collection_select(@object_name, method, collection, value_method, text_method, objectify_options(options), @default_options.merge(html_options))
end

#date_select(method, options = {}, html_options = {}) ⇒ Object


1026
1027
1028
# File 'actionpack/lib/action_view/helpers/date_helper.rb', line 1026

def date_select(method, options = {}, html_options = {})
  @template.date_select(@object_name, method, objectify_options(options), html_options)
end

#datetime_select(method, options = {}, html_options = {}) ⇒ Object


1034
1035
1036
# File 'actionpack/lib/action_view/helpers/date_helper.rb', line 1034

def datetime_select(method, options = {}, html_options = {})
  @template.datetime_select(@object_name, method, objectify_options(options), html_options)
end

#emitted_hidden_id?Boolean

Returns:

  • (Boolean)

1334
1335
1336
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1334

def emitted_hidden_id?
  @emitted_hidden_id ||= nil
end

#fields_for(record_name, record_object = nil, fields_options = {}, &block) ⇒ Object


1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1253

def fields_for(record_name, record_object = nil, fields_options = {}, &block)
  fields_options, record_object = record_object, nil if record_object.is_a?(Hash) && record_object.extractable_options?
  fields_options[:builder] ||= options[:builder]
  fields_options[:parent_builder] = self

  case record_name
  when String, Symbol
    if nested_attributes_association?(record_name)
      return fields_for_with_nested_attributes(record_name, record_object, fields_options, block)
    end
  else
    record_object = record_name.is_a?(Array) ? record_name.last : record_name
    record_name   = ActiveModel::Naming.param_key(record_object)
  end

  index = if options.has_key?(:index)
    "[#{options[:index]}]"
  elsif defined?(@auto_index)
    self.object_name = @object_name.to_s.sub(/\[\]$/,"")
    "[#{@auto_index}]"
  end
  record_name = "#{object_name}#{index}[#{record_name}]"

  @template.fields_for(record_name, record_object, fields_options, &block)
end

#file_field(method, options = {}) ⇒ Object


1296
1297
1298
1299
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1296

def file_field(method, options = {})
  self.multipart = true
  @template.file_field(@object_name, method, objectify_options(options))
end

#grouped_collection_select(method, collection, group_method, group_label_method, option_key_method, option_value_method, options = {}, html_options = {}) ⇒ Object


617
618
619
# File 'actionpack/lib/action_view/helpers/form_options_helper.rb', line 617

def grouped_collection_select(method, collection, group_method, group_label_method, option_key_method, option_value_method, options = {}, html_options = {})
  @template.grouped_collection_select(@object_name, method, collection, group_method, group_label_method, option_key_method, option_value_method, objectify_options(options), @default_options.merge(html_options))
end

#hidden_field(method, options = {}) ⇒ Object


1291
1292
1293
1294
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1291

def hidden_field(method, options = {})
  @emitted_hidden_id = true if method == :id
  @template.hidden_field(@object_name, method, objectify_options(options))
end

#label(method, text = nil, options = {}, &block) ⇒ Object


1279
1280
1281
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1279

def label(method, text = nil, options = {}, &block)
  @template.label(@object_name, method, text, objectify_options(options), &block)
end

#radio_button(method, tag_value, options = {}) ⇒ Object


1287
1288
1289
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1287

def radio_button(method, tag_value, options = {})
  @template.radio_button(@object_name, method, tag_value, objectify_options(options))
end

#select(method, choices, options = {}, html_options = {}) ⇒ Object


609
610
611
# File 'actionpack/lib/action_view/helpers/form_options_helper.rb', line 609

def select(method, choices, options = {}, html_options = {})
  @template.select(@object_name, method, choices, objectify_options(options), @default_options.merge(html_options))
end

#submit(value = nil, options = {}) ⇒ Object

Add the submit button for the given form. When no value is given, it checks if the object is a new resource or not to create the proper label:

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

In the example above, if @post is a new record, it will use “Create Post” as submit button label, otherwise, it uses “Update Post”.

Those labels can be customized using I18n, under the helpers.submit key and accept the %model as translation interpolation:

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

It also searches for a key specific for the given object:

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

1328
1329
1330
1331
1332
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1328

def submit(value=nil, options={})
  value, options = nil, value if value.is_a?(Hash)
  value ||= submit_default_value
  @template.submit_tag(value, options)
end

#time_select(method, options = {}, html_options = {}) ⇒ Object


1030
1031
1032
# File 'actionpack/lib/action_view/helpers/date_helper.rb', line 1030

def time_select(method, options = {}, html_options = {})
  @template.time_select(@object_name, method, objectify_options(options), html_options)
end

#time_zone_select(method, priority_zones = nil, options = {}, html_options = {}) ⇒ Object


621
622
623
# File 'actionpack/lib/action_view/helpers/form_options_helper.rb', line 621

def time_zone_select(method, priority_zones = nil, options = {}, html_options = {})
  @template.time_zone_select(@object_name, method, priority_zones, objectify_options(options), @default_options.merge(html_options))
end

#to_modelObject


1222
1223
1224
# File 'actionpack/lib/action_view/helpers/form_helper.rb', line 1222

def to_model
  self
end