nuatt-formtastic 0.2.2 → 0.2.3

data/lib/formtastic/inputs/hidden_input.rb

@@ -0,0 +1,66 @@
+module Formtastic
+  module Inputs
+
+    # Outputs a simple `<input type="hidden">` wrapped in the standard `<li>` wrapper. This is
+    # provided for situations where a hidden field needs to be rendered in the flow of a form with
+    # many inputs that form an `<ol>`. Wrapping the hidden input inside the `<li>` maintains the
+    # HTML validity. The `<li>` is marked with a `class` of `hidden` so that stylesheet authors can
+    # hide these list items with CSS (formtastic.css does this out of the box).
+    #
+    # @example Full form context, output and CSS
+    #
+    #   <%= semantic_form_for(@something) do |f| %>
+    #     <%= f.inputs do %>
+    #       <%= f.input :secret, :as => :hidden %>
+    #     <% end %>
+    #   <% end %>
+    #
+    #   <form...>
+    #     <fieldset>
+    #       <ol>
+    #         <li class="hidden">
+    #           <input type="hidden" id="something_secret" name="something[secret]">
+    #         </li>
+    #       </ol>
+    #     </fieldset>
+    #   </form>
+    #
+    #   form.formtastic li.hidden { display:none; }
+    #
+    # @see Formtastic::Helpers::InputsHelper#input InputsHelper#input for full documetation of all possible options.
+    class HiddenInput 
+      include Base
+      
+      # Override to include :value set directly from options hash. The :value set in :input_html 
+      # hash will be preferred over :value set directly in the options.
+      #
+      # @todo this is inconsistent with all other inputs, deprecate and remove
+      def input_html_options
+        {:value => options[:value]}.merge(super).merge(:required => nil)
+      end
+      
+      def to_html
+        input_wrapping do
+          builder.hidden_field(method, input_html_options)
+        end
+      end
+      
+      def error_html
+        ""
+      end
+      
+      def errors?
+        false
+      end
+      
+      def hint_html
+        ""
+      end
+      
+      def hint?
+        false
+      end
+
+    end
+  end
+end

data/lib/formtastic/inputs/number_input.rb

@@ -0,0 +1,72 @@
+module Formtastic
+  module Inputs
+
+    # Outputs a simple `<label>` with a HTML5 `<input type="number">` wrapped in the standard
+    # `<li>` wrapper. This is the default input choice for all database columns of the type `:float`
+    # and `:decimal`, as well as `:integer` columns that aren't used for `belongs_to` associations,
+    # but can be applied to any text-like input with `:as => :number`.
+    #
+    # @example Full form context and output
+    #
+    #   <%= semantic_form_for(@user) do |f| %>
+    #     <%= f.inputs do %>
+    #       <%= f.input :shoe_size, :as => :number %>
+    #     <% end %>
+    #   <% end %>
+    #
+    #   <form...>
+    #     <fieldset>
+    #       <ol>
+    #         <li class="numeric">
+    #           <label for="user_shoe_size">Shoe size</label>
+    #           <input type="number" id="user_shoe_size" name="user[shoe_size]">
+    #         </li>
+    #       </ol>
+    #     </fieldset>
+    #   </form>
+    #
+    # @example Default HTML5 min/max/step attributes are detected from the numericality validations
+    #
+    #   class Person < ActiveRecord::Base
+    #     validates_numericality_of :age, 
+    #       :less_than => 100, 
+    #       :greater_than => 17, 
+    #       :only_integer => true
+    #   end
+    #
+    #   <%= f.input :age, :as => :number %>
+    #
+    #   <li class="numeric">
+    #     <label for="persom_age">Age</label>
+    #     <input type="number" id="person_age" name="person[age]" min="18" max="99" step="1">
+    #   </li>
+    #
+    # @example Pass attributes down to the `<input>` tag
+    #  <%= f.input :shoe_size, :as => :number, :input_html => { :min => 3, :max => 15, :step => 1, :class => "special" } %>
+    #
+    # @see Formtastic::Helpers::InputsHelper#input InputsHelper#input for full documetation of all possible options.
+    # @see http://api.rubyonrails.org/classes/ActiveModel/Validations/HelperMethods.html#method-i-validates_numericality_of Rails' Numericality validation documentation
+    #
+    # @todo Rename/Alias to NumberInput
+    class NumberInput 
+      include Base
+      include Base::Stringish
+      
+      def to_html
+        input_wrapping do
+          label_html <<
+          builder.number_field(method, input_html_options)
+        end
+      end
+      
+      def input_html_options
+        {
+          :min => validation_min,
+          :max => validation_max,
+          :step => validation_integer_only? ? 1 : nil 
+        }.merge(super)
+      end
+      
+    end
+  end
+end

data/lib/formtastic/inputs/numeric_input.rb

@@ -0,0 +1,20 @@
+module Formtastic
+  module Inputs
+    # Alias for NumberInput for backwards compatibility with 1.x.
+    # 
+    # @example:
+    #   f.input :age, :as => :numeric
+    #
+    # @deprecated Use :as => :number instead
+    #
+    # @todo Remove on or after 2.1
+    class NumericInput < NumberInput
+      
+      def initialize(builder, template, object, object_name, method, options)
+        ActiveSupport::Deprecation.warn(':as => :numeric has been deprecated in favor of :as => :number and will be removed on or after version 2.1', caller)
+        super
+      end
+      
+    end
+  end
+end

data/lib/formtastic/inputs/password_input.rb

@@ -0,0 +1,40 @@
+module Formtastic
+  module Inputs
+
+    # Outputs a simple `<label>` with a `<input type="password">` wrapped in the standard
+    # `<li>` wrapper. This is the default input choice for all attributes matching `/password/`, but
+    # can be applied to any text-like input with `:as => :password`.
+    #
+    # @example Full form context and output
+    #
+    #   <%= semantic_form_for(@user) do |f| %>
+    #     <%= f.inputs do %>
+    #       <%= f.input :password, :as => :password %>
+    #     <% end %>
+    #   <% end %>
+    #
+    #   <form...>
+    #     <fieldset>
+    #       <ol>
+    #         <li class="password">
+    #           <label for="user_password">Password</label>
+    #           <input type="password" id="user_password" name="user[password]">
+    #         </li>
+    #       </ol>
+    #     </fieldset>
+    #   </form>
+    #
+    # @see Formtastic::Helpers::InputsHelper#input InputsHelper#input for full documetation of all possible options.
+    class PasswordInput 
+      include Base
+      include Base::Stringish
+      
+      def to_html
+        input_wrapping do
+          label_html <<
+          builder.password_field(method, input_html_options)
+        end
+      end
+    end
+  end
+end

data/lib/formtastic/inputs/phone_input.rb

@@ -0,0 +1,41 @@
+module Formtastic
+  module Inputs
+
+    # Outputs a simple `<label>` with a HTML5 `<input type="phone">` wrapped in the standard
+    # `<li>` wrapper. This is the default input choice for attributes with a name matching
+    # `/(phone|fax)/`, but can be applied to any text-like input with `:as => :phone`.
+    #
+    # @example Full form context and output
+    #
+    #   <%= semantic_form_for(@user) do |f| %>
+    #     <%= f.inputs do %>
+    #       <%= f.input :mobile, :as => :phone %>
+    #     <% end %>
+    #   <% end %>
+    #
+    #   <form...>
+    #     <fieldset>
+    #       <ol>
+    #         <li class="phone">
+    #           <label for="user_mobile">Mobile</label>
+    #           <input type="phone" id="user_mobile" name="user[mobile]">
+    #         </li>
+    #       </ol>
+    #     </fieldset>
+    #   </form>
+    #
+    # @see Formtastic::Helpers::InputsHelper#input InputsHelper#input for full documetation of all possible options.
+    class PhoneInput 
+      include Base
+      include Base::Stringish
+      
+      def to_html
+        input_wrapping do
+          label_html <<
+          builder.phone_field(method, input_html_options)
+        end
+      end
+    end
+    
+  end
+end

data/lib/formtastic/inputs/radio_input.rb

@@ -0,0 +1,146 @@
+module Formtastic
+  module Inputs
+
+    # A radio input is used to render a series of radio inputs. This is an alternative input choice
+    # for `belongs_to` associations like a `Post` belonging to a `Section` or an `Author`, or any
+    # case where the user needs to make a single selection from a pre-defined collectioon of choices.
+    #
+    # Within the standard `<li>` wrapper, the output is a `<fieldset>` with a `<legend>` to
+    # represent the "label" for the input, and an `<ol>` containing `<li>`s for each choice in
+    # the association. Each `<li>` choice has a `<label>` containing an `<input type="radio">` and
+    # the label text to describe each choice.
+    #
+    # Radio inputs can be considered as an alternative where a (non-multi) select input is used,
+    # especially in cases where there are only a few choices, however they are not used by default
+    # for any type of association or model attribute. You can choose to use a radio input instead of
+    # a select with `:as => :radio`.
+    #
+    # Like a select input, the flexibility of the `:collection` option (see examples) makes the
+    # :radio input viable as an alternative for many other input types. For example, instead of...
+    #
+    # * a `:string` input (where you want to force the user to choose from a few specific strings rather than entering anything)
+    # * a `:boolean` checkbox input (where the user could choose yes or no, rather than checking a box)
+    # * a `:date`, `:time` or `:datetime` input (where the user could choose from a small set of pre-determined dates)
+    # * a `:number` input (where the user could choose from a small set of pre-defined numbers)
+    # * a `:time_zone` input (where you want to provide your own small set of choices instead of relying on Rails)
+    # * a `:country` input (where you want to provide a small set of choices, no need for a plugin really)
+    #
+    # For radio inputs that map to associations on the object model, Formtastic will automatically
+    # load in a collection of objects on the association as options to choose from. This might be an
+    # `Author.all` on a `Post` form with an input for a `belongs_to :user` association, or a
+    # `Section.all` for a `Post` form with an input for a `belongs_to :section` association.
+    # You can override or customise this collection through the `:collection` option (see examples).
+    #
+    # The way on which Formtastic renders the `value` attribute and label for each choice is
+    # customisable through the `:label_method` and `:value_method` options (see examples below).
+    # When not provided, we fall back to a list of methods to try on each object such as
+    # `:to_label`, `:name` and `:to_s`, which are defined in the configurations
+    # `collection_label_methods` and `collection_value_methods`.
+    #
+    # @example Basic `belongs_to` example with full form context
+    #
+    #     <%= semantic_form_for @post do |f| %>
+    #       <%= f.inputs do %>
+    #         <%= f.input :author, :as => :radio %>
+    #       <% end %>
+    #     <% end %>
+    #
+    #     <form...>
+    #       <fieldset>
+    #         <ol>
+    #           <li class='radio'>
+    #             <fieldset>
+    #               <legend class="label"><label>Categories</label></legend>
+    #               <ol>
+    #                 <li>
+    #                   <label for="post_author_id_1">
+    #                     <input type="radio" id="post_author_id_1" value="1"> Justin
+    #                   </label>
+    #                 </li>
+    #                 <li>
+    #                   <label for="post_author_id_3">
+    #                     <input type="radio" id="post_author_id_3" value="3"> Kate
+    #                   </label>
+    #                 </li>
+    #                 <li>
+    #                   <label for="post_author_id_2">
+    #                     <input type="radio" id="post_author_id_2" value="2"> Amelia
+    #                   </label>
+    #                 </li>
+    #               </ol>
+    #             </fieldset>
+    #           </li>
+    #         </ol>
+    #       </fieldset>
+    #     </form>
+    #
+    # @example The `:collection` option can be used to customize the choices
+    #   <%= f.input :author, :as => :radio, :collection => @authors %>
+    #   <%= f.input :author, :as => :radio, :collection => Author.all %>
+    #   <%= f.input :author, :as => :radio, :collection => Author.some_named_scope %>
+    #   <%= f.input :author, :as => :radio, :collection => [Author.find_by_login("justin"), Category.find_by_name("kate")] %>
+    #   <%= f.input :author, :as => :radio, :collection => ["Justin", "Kate"] %>
+    #   <%= f.input :author, :as => :radio, :collection => [["Justin", "justin"], ["Kate", "kate"]] %>
+    #   <%= f.input :author, :as => :radio, :collection => [["Justin", "1"], ["Kate", "3"]] %>
+    #   <%= f.input :author, :as => :radio, :collection => [["Justin", 1], ["Kate", 3]] %>
+    #   <%= f.input :author, :as => :radio, :collection => 1..5 %>
+    #
+    # @example The `:label_method` can be used to call a different method (or a Proc) on each object in the collection for rendering the label text (it'll try the methods like `to_s` in `collection_label_methods` config by default)
+    #   <%= f.input :author, :as => :radio, :label_method => :name %>
+    #   <%= f.input :author, :as => :radio, :label_method => :name_with_post_count
+    #   <%= f.input :author, :as => :radio, :label_method => Proc.new { |a| "#{c.name} (#{pluralize("post", a.posts.count)})" }
+    #
+    # @example The `:value_method` can be used to call a different method (or a Proc) on each object in the collection for rendering the value for each checkbox (it'll try the methods like `id` in `collection_value_methods` config by default)
+    #   <%= f.input :author, :as => :radio, :value_method => :login %>
+    #   <%= f.input :author, :as => :radio, :value_method => Proc.new { |c| c.full_name.downcase.underscore }
+    #
+    # @example Set HTML attributes on each `<input type="radio">` tag with `:input_html`
+    #   <%= f.input :author, :as => :radio, :input_html => { :size => 20, :multiple => true, :class => "special" } %>
+    #
+    # @example Set HTML attributes on the `<li>` wrapper with `:wrapper_html`
+    #   <%= f.input :author, :as => :radio, :wrapper_html => { :class => "special" } %>
+    #
+    # @example `:value_as_class` can be used to add a class to the `<li>` wrapped around each choice using the radio value for custom styling of each choice
+    #   <%= f.input :author, :as => :radio, :value_as_class => true %>
+    #
+    # @see Formtastic::Helpers::InputsHelper#input InputsHelper#input for full documetation of all possible options.
+    # @see Formtastic::Inputs::RadioInput as an alternative for `belongs_to` associations
+    #
+    # @todo :disabled like CheckBoxes?
+    class RadioInput
+      include Base
+      include Base::Collections
+      include Base::Choices
+      
+      def to_html
+        input_wrapping do
+          choices_wrapping do
+            legend_html <<
+            choices_group_wrapping do
+              collection.map { |choice| 
+                choice_wrapping(choice_wrapping_html_options(choice)) do
+                  choice_html(choice)
+                end
+              }.join("\n").html_safe
+            end
+          end
+        end
+      end
+
+      def choice_html(choice)        
+        template.content_tag(:label,
+          builder.radio_button(input_name, choice_value(choice), input_html_options.merge(:id => choice_input_dom_id(choice))) << 
+          choice_label(choice),
+          label_html_options.merge(:for => choice_input_dom_id(choice))
+        )
+      end
+      
+      # Override to remove the for attribute since this isn't associated with any element, as it's
+      # nested inside the legend.
+      def label_html_options
+        super.merge(:for => nil)
+      end
+
+    end
+  end
+end

data/lib/formtastic/inputs/search_input.rb

@@ -0,0 +1,40 @@
+module Formtastic
+  module Inputs
+
+    # Outputs a simple `<label>` with a HTML5 `<input type="search">` wrapped in the standard
+    # `<li>` wrapper. This is the default input choice for attributes with a name matching
+    # `/^search$/`, but can be applied to any text-like input with `:as => :search`.
+    #
+    # @example Full form context and output
+    #
+    #   <%= semantic_form_for(@search, :html => { :method => :get }) do |f| %>
+    #     <%= f.inputs do %>
+    #       <%= f.input :q, :as => :search, :label => false, :input_html => { :name => "q" } %>
+    #     <% end %>
+    #   <% end %>
+    #
+    #   <form...>
+    #     <fieldset>
+    #       <ol>
+    #         <li class="search">
+    #           <input type="search" id="search_q" name="q">
+    #         </li>
+    #       </ol>
+    #     </fieldset>
+    #   </form>
+    #
+    # @see Formtastic::Helpers::InputsHelper#input InputsHelper#input for full documetation of all possible options.
+    class SearchInput 
+      include Base
+      include Base::Stringish
+      
+      def to_html
+        input_wrapping do
+          label_html <<
+          builder.search_field(method, input_html_options)
+        end
+      end
+    end
+
+  end
+end

data/lib/formtastic/inputs/select_input.rb

@@ -0,0 +1,208 @@
+module Formtastic
+  module Inputs
+    # A select input is used to render a `<select>` tag with a series of options to choose from.
+    # It works for both single selections (like a `belongs_to` relationship, or "yes/no" boolean),
+    # as well as multiple selections (like a `has_and_belongs_to_many`/`has_many` relationship,
+    # for assigning many genres to a song, for example).
+    #
+    # This is the default input choice when:
+    #
+    # * the database column type is an `:integer` and there is an association (`belongs_to`)
+    # * the database column type is a `:string` and the `:collection` option is used
+    # * there an object with an association, but no database column on the object (`has_many`, etc)
+    # * there is no object and the `:collection` option is used
+    #
+    # The flexibility of the `:collection` option (see examples) makes the :select input viable as
+    # an alternative for many other input types. For example, instead of...
+    #
+    # * a `:string` input (where you want to force the user to choose from a few specific strings rather than entering anything)
+    # * a `:boolean` checkbox input (where the user could choose yes or no, rather than checking a box)
+    # * a `:date`, `:time` or `:datetime` input (where the user could choose from pre-selected dates)
+    # * a `:number` input (where the user could choose from a set of pre-defined numbers)
+    # * a `:time_zone` input (where you want to provide your own set of choices instead of relying on Rails)
+    # * a `:country` input (no need for a plugin really)
+    #
+    # Within the standard `<li>` wrapper, the output is a `<label>` tag followed by a `<select>`
+    # tag containing `<option>` tags.
+    #
+    # For inputs that map to associations on the object model, Formtastic will automatically load
+    # in a collection of objects on the association as options to choose from. This might be an
+    # `Author.all` on a `Post` form with an input for a `belongs_to :user` association, or a
+    # `Tag.all` for a `Post` form with an input for a `has_and_belongs_to_many :tags` association.
+    # You can override or customise this collection and the `<option>` tags it will render through
+    # the `:collection` option (see examples).
+    #
+    # The way on which Formtastic renders the `value` attribute and content of each `<option>` tag
+    # is customisable through the `:label_method` and `:value_method` options. When not provided,
+    # we fall back to a list of methods to try on each object such as `:to_label`, `:name` and
+    # `:to_s`, which are defined in the configurations `collection_label_methods` and
+    # `collection_value_methods` (see examples below).
+    #
+    # @example Basic `belongs_to` example with full form context
+    #
+    #     <%= semantic_form_for @post do |f| %>
+    #       <%= f.inputs do %>
+    #         <%= f.input :author, :as => :select %>
+    #       <% end %>
+    #     <% end %>
+    #
+    #     <form...>
+    #       <fieldset>
+    #         <ol>
+    #           <li class='select'>
+    #             <label for="post_author_id">Author</label>
+    #             <select id="post_author_id" name="post[post_author_id]">
+    #               <option value=""></option>
+    #               <option value="1">Justin</option>
+    #               <option value="3">Kate</option>
+    #               <option value="2">Amelia</option>
+    #             </select>
+    #           </li>
+    #         </ol>
+    #       </fieldset>
+    #     </form>
+    #
+    # @example Basic `has_many` or `has_and_belongs_to_many` example with full form context
+    #
+    #     <%= semantic_form_for @post do |f| %>
+    #       <%= f.inputs do %>
+    #         <%= f.input :tags, :as => :select %>
+    #       <% end %>
+    #     <% end %>
+    #
+    #     <form...>
+    #       <fieldset>
+    #         <ol>
+    #           <li class='select'>
+    #             <label for="post_tag_ids">Author</label>
+    #             <select id="post_tag_ids" name="post[tag_ids]" multiple="true">
+    #               <option value="1">Ruby</option>
+    #               <option value="6">Rails</option>
+    #               <option value="3">Forms</option>
+    #               <option value="4">Awesome</option>
+    #             </select>
+    #           </li>
+    #         </ol>
+    #       </fieldset>
+    #     </form>
+    #
+    # @example Override Formtastic's assumption on when you need a multi select
+    #   <%= f.input :authors, :as => :select, :input_html => { :multiple => true } %>
+    #   <%= f.input :authors, :as => :select, :input_html => { :multiple => false } %>
+    #
+    # @example The `:collection` option can be used to customize the choices
+    #   <%= f.input :author, :as => :select, :collection => @authors %>
+    #   <%= f.input :author, :as => :select, :collection => Author.all %>
+    #   <%= f.input :author, :as => :select, :collection => Author.some_named_scope %>
+    #   <%= f.input :author, :as => :select, :collection => [Author.find_by_login("justin"), Category.find_by_name("kate")] %>
+    #   <%= f.input :author, :as => :select, :collection => ["Justin", "Kate"] %>
+    #   <%= f.input :author, :as => :select, :collection => [["Justin", "justin"], ["Kate", "kate"]] %>
+    #   <%= f.input :author, :as => :select, :collection => [["Justin", "1"], ["Kate", "3"]] %>
+    #   <%= f.input :author, :as => :select, :collection => [["Justin", 1], ["Kate", 3]] %>
+    #   <%= f.input :author, :as => :select, :collection => 1..5 %>
+    #   <%= f.input :author, :as => :select, :collection => "<option>your own options HTML string</option>" %>
+    #   <%= f.input :author, :as => :select, :collection => options_for_select(...) %>
+    #   <%= f.input :author, :as => :select, :collection => options_from_collection_for_select(...) %>
+    #   <%= f.input :author, :as => :select, :collection => grouped_options_for_select(...) %>
+    #   <%= f.input :author, :as => :select, :collection => time_zone_options_for_select(...) %>
+    #
+    # @example The `:label_method` can be used to call a different method (or a Proc) on each object in the collection for rendering the label text (it'll try the methods like `to_s` in `collection_label_methods` config by default)
+    #   <%= f.input :author, :as => :select, :label_method => :name %>
+    #   <%= f.input :author, :as => :select, :label_method => :name_with_post_count
+    #   <%= f.input :author, :as => :select, :label_method => Proc.new { |a| "#{c.name} (#{pluralize("post", a.posts.count)})" }
+    #
+    # @example The `:value_method` can be used to call a different method (or a Proc) on each object in the collection for rendering the value for each checkbox (it'll try the methods like `id` in `collection_value_methods` config by default)
+    #   <%= f.input :author, :as => :select, :value_method => :login %>
+    #   <%= f.input :author, :as => :select, :value_method => Proc.new { |c| c.full_name.downcase.underscore }
+    #
+    # @example Set HTML attributes on the `<select>` tag with `:input_html`
+    #   <%= f.input :authors, :as => :select, :input_html => { :size => 20, :multiple => true, :class => "special" } %>
+    #
+    # @example Set HTML attributes on the `<li>` wrapper with `:wrapper_html`
+    #   <%= f.input :authors, :as => :select, :wrapper_html => { :class => "special" } %>
+    #
+    # @example Exclude or include the blank option at the top of the select, or change the prompt
+    #   <%= f.input :author, :as => :select, :input_html => { :include_blank => false } %>
+    #   <%= f.input :author, :as => :select, :input_html => { :include_blank => true } %>
+    #   <%= f.input :author, :as => :select, :input_html => { :prompt => "Please select an Author..." } %>
+    #
+    # @example Group options an `<optgroup>` with the `:group_by` and `:group_label_method` options (`belongs_to` associations only)
+    #   <%= f.input :author, :as => :select, :group_by => :continent %>
+    #
+    # @see Formtastic::Helpers::InputsHelper#input InputsHelper#input for full documetation of all possible options.
+    # @see Formtastic::Inputs::CheckBoxesInput CheckBoxesInput as an alternative for `has_many` and `has_and_belongs_to_many` associations
+    # @see Formtastic::Inputs::RadioInput RadioInput as an alternative for `belongs_to` associations
+    class SelectInput
+      include Base
+      include Base::Collections
+      include Base::GroupedCollections
+      
+      def to_html
+        input_wrapping do
+          label_html <<
+          (options[:group_by] ? grouped_select_html : select_html)
+        end
+      end
+      
+      def select_html
+        builder.select(input_name, collection, input_options, input_html_options)
+      end
+      
+      def grouped_select_html
+        builder.grouped_collection_select(
+          input_name, 
+          grouped_collection,
+          group_association, 
+          group_label_method,
+          value_method, 
+          label_method,
+          input_options, 
+          input_html_options
+        )
+      end
+      
+      def include_blank?
+        return options[:prompt] if options.key?(:prompt)
+        return options[:include_blank] if options.key?(:include_blank)
+        return true if (single? && builder.include_blank_for_select_by_default)
+        false
+      end
+
+      def label_html_options
+        super.merge(:for => input_html_options[:id])
+      end
+      
+      def input_options
+        {:include_blank => include_blank?}.merge(super)
+      end
+      
+      def input_html_options
+        extra_input_html_options.merge(super)
+      end
+      
+      def extra_input_html_options
+        {
+          :multiple => multiple_by_association?,
+          :name => "#{object_name}[#{association_primary_key}]"
+        }
+      end
+      
+      def multiple_by_association?
+        reflection && [ :has_many, :has_and_belongs_to_many ].include?(reflection.macro)
+      end
+      
+      def multiple_by_options?
+        options[:multiple]
+      end
+      
+      def multiple?
+        multiple_by_options? || multiple_by_association? 
+      end
+      
+      def single?
+        !multiple?
+      end
+        
+    end
+  end
+end