simple_form 1.5.2 → 2.0.0

data/test/form_builder/general_test.rb

@@ -0,0 +1,356 @@
+# encoding: UTF-8
+require 'test_helper'
+
+class FormBuilderTest < ActionView::TestCase
+  def with_custom_form_for(object, *args, &block)
+    with_concat_custom_form_for(object) do |f|
+      f.input(*args, &block)
+    end
+  end
+
+  test 'nested simple fields should yield an instance of FormBuilder' do
+    simple_form_for :user do |f|
+      f.simple_fields_for :posts do |posts_form|
+        assert posts_form.instance_of?(SimpleForm::FormBuilder)
+      end
+    end
+  end
+
+  test 'builder input is html safe' do
+    simple_form_for @user do |f|
+      assert f.input(:name).html_safe?
+    end
+  end
+
+  test 'builder input should allow a block to configure input' do
+    with_form_for @user, :name do
+      text_field_tag :foo, :bar, :id => :cool
+    end
+    assert_no_select 'input.string'
+    assert_select 'input#cool'
+  end
+
+  test 'builder should allow adding custom input mappings for default input types' do
+    swap SimpleForm, :input_mappings => { /count$/ => :integer } do
+      with_form_for @user, :post_count
+      assert_no_select 'form input#user_post_count.string'
+      assert_select 'form input#user_post_count.numeric.integer'
+    end
+  end
+
+  test 'builder should allow to skip input_type class' do
+    swap SimpleForm, :generate_additional_classes_for => [:label, :wrapper] do
+      with_form_for @user, :post_count
+      assert_no_select "form input#user_post_count.integer"
+      assert_select "form input#user_post_count"
+    end
+  end
+
+  test 'builder should allow adding custom input mappings for integer input types' do
+    swap SimpleForm, :input_mappings => { /lock_version/ => :hidden } do
+      with_form_for @user, :lock_version
+      assert_no_select 'form input#user_lock_version.integer'
+      assert_select 'form input#user_lock_version.hidden'
+    end
+  end
+
+  test 'builder uses the first matching custom input map when more than one matches' do
+    swap SimpleForm, :input_mappings => { /count$/ => :integer, /^post_/ => :password } do
+      with_form_for @user, :post_count
+      assert_no_select 'form input#user_post_count.password'
+      assert_select 'form input#user_post_count.numeric.integer'
+    end
+  end
+
+  test 'builder uses the custom map only for matched attributes' do
+    swap SimpleForm, :input_mappings => { /lock_version/ => :hidden } do
+      with_form_for @user, :post_count
+      assert_no_select 'form input#user_post_count.hidden'
+      assert_select 'form input#user_post_count.string'
+    end
+  end
+
+  # INPUT TYPES
+  test 'builder should generate text fields for string columns' do
+    with_form_for @user, :name
+    assert_select 'form input#user_name.string'
+  end
+
+  test 'builder should generate text areas for text columns' do
+    with_form_for @user, :description
+    assert_select 'form textarea#user_description.text'
+  end
+
+  test 'builder should generate a checkbox for boolean columns' do
+    with_form_for @user, :active
+    assert_select 'form input[type=checkbox]#user_active.boolean'
+  end
+
+  test 'builder should use integer text field for integer columns' do
+    with_form_for @user, :age
+    assert_select 'form input#user_age.numeric.integer'
+  end
+
+  test 'builder should generate decimal text field for decimal columns' do
+    with_form_for @user, :credit_limit
+    assert_select 'form input#user_credit_limit.numeric.decimal'
+  end
+
+  test 'builder should generate password fields for columns that matches password' do
+    with_form_for @user, :password
+    assert_select 'form input#user_password.password'
+  end
+
+  test 'builder should generate country fields for columns that matches country' do
+    with_form_for @user, :residence_country
+    assert_select 'form select#user_residence_country.country'
+  end
+
+  test 'builder should generate time_zone fields for columns that matches time_zone' do
+    with_form_for @user, :time_zone
+    assert_select 'form select#user_time_zone.time_zone'
+  end
+
+  test 'builder should generate email fields for columns that matches email' do
+    with_form_for @user, :email
+    assert_select 'form input#user_email.string.email'
+  end
+
+  test 'builder should generate tel fields for columns that matches phone' do
+    with_form_for @user, :phone_number
+    assert_select 'form input#user_phone_number.string.tel'
+  end
+
+  test 'builder should generate url fields for columns that matches url' do
+    with_form_for @user, :url
+    assert_select 'form input#user_url.string.url'
+  end
+
+  test 'builder should generate date select for date columns' do
+    with_form_for @user, :born_at
+    assert_select 'form select#user_born_at_1i.date'
+  end
+
+  test 'builder should generate time select for time columns' do
+    with_form_for @user, :delivery_time
+    assert_select 'form select#user_delivery_time_4i.time'
+  end
+
+  test 'builder should generate datetime select for datetime columns' do
+    with_form_for @user, :created_at
+    assert_select 'form select#user_created_at_1i.datetime'
+  end
+
+  test 'builder should generate datetime select for timestamp columns' do
+    with_form_for @user, :updated_at
+    assert_select 'form select#user_updated_at_1i.datetime'
+  end
+
+  test 'builder should generate file for file columns' do
+    @user.avatar = mock("file")
+    @user.avatar.expects(:respond_to?).with(:mounted_as).returns(false)
+    @user.avatar.expects(:respond_to?).with(:file?).returns(false)
+    @user.avatar.expects(:respond_to?).with(:public_filename).returns(true)
+
+    with_form_for @user, :avatar
+    assert_select 'form input#user_avatar.file'
+  end
+
+  test 'builder should generate file for attributes that are real db columns but have file methods' do
+    @user.home_picture = mock("file")
+    @user.home_picture.expects(:respond_to?).with(:mounted_as).returns(true)
+
+    with_form_for @user, :home_picture
+    assert_select 'form input#user_home_picture.file'
+  end
+
+  test 'build should generate select if a collection is given' do
+    with_form_for @user, :age, :collection => 1..60
+    assert_select 'form select#user_age.select'
+  end
+
+  test 'builder should allow overriding default input type for text' do
+    with_form_for @user, :name, :as => :text
+    assert_no_select 'form input#user_name'
+    assert_select 'form textarea#user_name.text'
+
+    with_form_for @user, :active, :as => :radio_buttons
+    assert_no_select 'form input[type=checkbox]'
+    assert_select 'form input.radio_buttons[type=radio]', :count => 2
+
+    with_form_for @user, :born_at, :as => :string
+    assert_no_select 'form select'
+    assert_select 'form input#user_born_at.string'
+  end
+
+  # COMMON OPTIONS
+  test 'builder should add chosen form class' do
+    swap SimpleForm, :form_class => :my_custom_class do
+      with_form_for @user, :name
+      assert_select 'form.my_custom_class'
+    end
+  end
+
+  test 'builder should allow passing options to input' do
+    with_form_for @user, :name, :input_html => { :class => 'my_input', :id => 'my_input' }
+    assert_select 'form input#my_input.my_input.string'
+  end
+
+  test 'builder should not propagate input options to wrapper' do
+    with_form_for @user, :name, :input_html => { :class => 'my_input', :id => 'my_input' }
+    assert_no_select 'form div.input.my_input.string'
+    assert_select 'form input#my_input.my_input.string'
+  end
+
+  test 'builder should generate a input with label' do
+    with_form_for @user, :name
+    assert_select 'form label.string[for=user_name]', /Name/
+  end
+
+  test 'builder should be able to disable the label for a input' do
+    with_form_for @user, :name, :label => false
+    assert_no_select 'form label'
+  end
+
+  test 'builder should use custom label' do
+    with_form_for @user, :name, :label => 'Yay!'
+    assert_select 'form label', /Yay!/
+  end
+
+  test 'builder should pass options to label' do
+    with_form_for @user, :name, :label_html => { :id => "cool" }
+    assert_select 'form label#cool', /Name/
+  end
+
+  test 'builder should not generate hints for a input' do
+    with_form_for @user, :name
+    assert_no_select 'span.hint'
+  end
+
+  test 'builder should be able to add a hint for a input' do
+    with_form_for @user, :name, :hint => 'test'
+    assert_select 'span.hint', 'test'
+  end
+
+  test 'builder should be able to disable a hint even if it exists in i18n' do
+    store_translations(:en, :simple_form => { :hints => { :name => 'Hint test' } }) do
+      with_form_for @user, :name, :hint => false
+      assert_no_select 'span.hint'
+    end
+  end
+
+  test 'builder should pass options to hint' do
+    with_form_for @user, :name, :hint => 'test', :hint_html => { :id => "cool" }
+    assert_select 'span.hint#cool', 'test'
+  end
+
+  test 'builder should generate errors for attribute without errors' do
+    with_form_for @user, :credit_limit
+    assert_no_select 'span.errors'
+  end
+
+  test 'builder should generate errors for attribute with errors' do
+    with_form_for @user, :name
+    assert_select 'span.error', "can't be blank"
+  end
+
+  test 'builder should be able to disable showing errors for a input' do
+    with_form_for @user, :name, :error => false
+    assert_no_select 'span.error'
+  end
+
+  test 'builder should pass options to errors' do
+    with_form_for @user, :name, :error_html => { :id => "cool" }
+    assert_select 'span.error#cool', "can't be blank"
+  end
+
+  test 'placeholder should not be generated when set to false' do
+    store_translations(:en, :simple_form => { :placeholders => { :user => {
+      :name => 'Name goes here'
+    } } }) do
+      with_form_for @user, :name, :placeholder => false
+      assert_no_select 'input[placeholder]'
+    end
+  end
+
+  # DEFAULT OPTIONS
+  test 'builder should receive a default argument and pass it to the inputs' do
+    with_concat_form_for @user, :defaults => { :input_html => { :class => 'default_class' } } do |f|
+      f.input :name
+    end
+    assert_select 'input.default_class'
+  end
+
+  test 'builder should receive a default argument and pass it to the inputs, respecting the specific options' do
+    with_concat_form_for @user, :defaults => { :input_html => { :class => 'default_class' } } do |f|
+      f.input :name, :input_html => { :id => 'specific_id' }
+    end
+    assert_select 'input.default_class#specific_id'
+  end
+
+  test 'builder should receive a default argument and pass it to the inputs, overwriting the defaults with specific options' do
+    with_concat_form_for @user, :defaults => { :input_html => { :class => 'default_class', :id => 'default_id' } } do |f|
+      f.input :name, :input_html => { :id => 'specific_id' }
+    end
+    assert_select 'input.default_class#specific_id'
+  end
+
+  test 'builder should receive a default argument and pass it to the inputs without changing the defaults' do
+    with_concat_form_for @user, :defaults => { :input_html => { :class => 'default_class', :id => 'default_id' } } do |f|
+      concat(f.input :name)
+      concat(f.input :credit_limit)
+    end
+
+    assert_select "input.string.default_class[name='user[name]']"
+    assert_no_select "input.string[name='user[credit_limit]']"
+  end
+
+  # WITHOUT OBJECT
+  test 'builder should generate properly when object is not present' do
+    with_form_for :project, :name
+    assert_select 'form input.string#project_name'
+  end
+
+  test 'builder should generate password fields based on attribute name when object is not present' do
+    with_form_for :project, :password_confirmation
+    assert_select 'form input[type=password].password#project_password_confirmation'
+  end
+
+  test 'builder should generate text fields by default for all attributes when object is not present' do
+    with_form_for :project, :created_at
+    assert_select 'form input.string#project_created_at'
+    with_form_for :project, :budget
+    assert_select 'form input.string#project_budget'
+  end
+
+  test 'builder should allow overriding input type when object is not present' do
+    with_form_for :project, :created_at, :as => :datetime
+    assert_select 'form select.datetime#project_created_at_1i'
+    with_form_for :project, :budget, :as => :decimal
+    assert_select 'form input.decimal#project_budget'
+  end
+
+  # CUSTOM FORM BUILDER
+  test 'custom builder should inherit mappings' do
+    with_custom_form_for @user, :email
+    assert_select 'form input[type=email]#user_email.custom'
+  end
+
+  test 'form with CustomMapTypeFormBuilder should use custom map type builder' do
+    with_concat_custom_mapping_form_for(:user) do |user|
+      assert user.instance_of?(CustomMapTypeFormBuilder)
+    end
+  end
+
+  test 'form with CustomMapTypeFormBuilder should use custom mapping' do
+    with_concat_custom_mapping_form_for(:user) do |user|
+      assert_equal SimpleForm::Inputs::StringInput, user.class.mappings[:custom_type]
+    end
+  end
+
+  test 'form without CustomMapTypeFormBuilder should not use custom mapping' do
+    with_concat_form_for(:user) do |user|
+      assert_nil user.class.mappings[:custom_type]
+    end
+  end
+end

data/test/form_builder/hint_test.rb

@@ -0,0 +1,123 @@
+require 'test_helper'
+
+# Tests for f.hint
+class HintTest < ActionView::TestCase
+  def with_hint_for(object, *args)
+    with_concat_form_for(object) do |f|
+      f.hint(*args)
+    end
+  end
+
+  test 'hint should not be generated by default' do
+    with_hint_for @user, :name
+    assert_no_select 'span.hint'
+  end
+
+  test 'hint should be generated with optional text' do
+    with_hint_for @user, :name, :hint => 'Use with care...'
+    assert_select 'span.hint', 'Use with care...'
+  end
+
+  test 'hint should not modify the options hash' do
+    options = { :hint => 'Use with care...' }
+    with_hint_for @user, :name, options
+    assert_select 'span.hint', 'Use with care...'
+    assert_equal({ :hint => 'Use with care...' }, options)
+  end
+
+  test 'hint should be generated cleanly with optional text' do
+    with_hint_for @user, :name, :hint => 'Use with care...', :hint_tag => :span
+    assert_no_select 'span.hint[hint]'
+    assert_no_select 'span.hint[hint_tag]'
+    assert_no_select 'span.hint[hint_html]'
+  end
+
+  test 'hint uses the current component tag set' do
+    with_hint_for @user, :name, :hint => 'Use with care...', :hint_tag => :p
+    assert_select 'p.hint', 'Use with care...'
+  end
+
+  test 'hint should be able to pass html options' do
+    with_hint_for @user, :name, :hint => 'Yay!', :id => 'hint', :class => 'yay'
+    assert_select 'span#hint.hint.yay'
+  end
+
+  # Without attribute name
+
+  test 'hint without attribute name' do
+    with_hint_for @validating_user, 'Hello World!'
+    assert_select 'span.hint', 'Hello World!'
+  end
+
+  test 'hint without attribute name should generate component tag with a clean HTML' do
+    with_hint_for @validating_user, 'Hello World!'
+    assert_no_select 'span.hint[hint]'
+    assert_no_select 'span.hint[hint_html]'
+  end
+
+  test 'hint without attribute name uses the current component tag set' do
+    with_hint_for @user, 'Hello World!', :hint_tag => :p
+    assert_no_select 'p.hint[hint]'
+    assert_no_select 'p.hint[hint_html]'
+    assert_no_select 'p.hint[hint_tag]'
+  end
+
+  test 'hint without attribute name should be able to pass html options' do
+    with_hint_for @user, 'Yay', :id => 'hint', :class => 'yay'
+    assert_select 'span#hint.hint.yay', 'Yay'
+  end
+
+  # I18n
+
+  test 'hint should use i18n based on model, action, and attribute to lookup translation' do
+    store_translations(:en, :simple_form => { :hints => { :user => {
+      :edit => { :name => 'Content of this input will be truncated...' }
+    } } }) do
+      with_hint_for @user, :name
+      assert_select 'span.hint', 'Content of this input will be truncated...'
+    end
+  end
+
+  test 'hint should use i18n with model and attribute to lookup translation' do
+    store_translations(:en, :simple_form => { :hints => { :user => {
+      :name => 'Content of this input will be capitalized...'
+    } } }) do
+      with_hint_for @user, :name
+      assert_select 'span.hint', 'Content of this input will be capitalized...'
+    end
+  end
+
+  test 'hint should use i18n under defaults namespace to lookup translation' do
+    store_translations(:en, :simple_form => {
+      :hints => {:defaults => {:name => 'Content of this input will be downcased...' } }
+    }) do
+      with_hint_for @user, :name
+      assert_select 'span.hint', 'Content of this input will be downcased...'
+    end
+  end
+
+  test 'hint should use i18n with lookup for association name' do
+    store_translations(:en, :simple_form => { :hints => {
+      :user => { :company => 'My company!' }
+    } } ) do
+      with_hint_for @user, :company_id, :as => :string, :reflection => Association.new(Company, :company, {})
+      assert_select 'span.hint', /My company!/
+    end
+  end
+
+  # No object
+
+  test 'hint should generate properly when object is not present' do
+    with_hint_for :project, :name, :hint => 'Test without object'
+    assert_select 'span.hint', 'Test without object'
+  end
+
+  # Custom wrappers
+
+  test 'hint with custom wrappers works' do
+    swap_wrapper do
+      with_hint_for @user, :name, :hint => "can't be blank"
+      assert_select 'div.omg_hint', "can't be blank"
+    end
+  end
+end

data/test/form_builder/input_field_test.rb

@@ -0,0 +1,63 @@
+require 'test_helper'
+
+# Tests for f.input_field
+class InputFieldTest < ActionView::TestCase
+  test "builder input_field should only render the input tag, nothing else" do
+    with_concat_form_for(@user) do |f|
+      f.input_field :name
+    end
+    assert_select 'form > input.required.string'
+    assert_no_select 'div.string'
+    assert_no_select 'label'
+    assert_no_select '.hint'
+  end
+
+  test 'builder input_field should allow overriding default input type' do
+    with_concat_form_for(@user) do |f|
+      f.input_field :name, :as => :text
+    end
+
+    assert_no_select 'input#user_name'
+    assert_select 'textarea#user_name.text'
+  end
+
+  test 'builder input_field should allow passing options to input tag' do
+    with_concat_form_for(@user) do |f|
+      f.input_field :name, :id => 'name_input', :class => 'name'
+    end
+
+    assert_select 'input.string.name#name_input'
+  end
+
+  test 'builder input_field should not modify the options hash' do
+    options = { :id => 'name_input', :class => 'name' }
+
+    with_concat_form_for(@user) do |f|
+      f.input_field :name, options
+    end
+
+    assert_select 'input.string.name#name_input'
+    assert_equal({ :id => 'name_input', :class => 'name' }, options)
+  end
+
+
+  test 'builder input_field should generate an input tag with a clean HTML' do
+    with_concat_form_for(@user) do |f|
+      f.input_field :name, :as => :integer, :class => 'name'
+    end
+
+    assert_no_select 'input.integer[input_html]'
+    assert_no_select 'input.integer[as]'
+  end
+
+  test 'builder collection input_field should generate input tag with a clean HTML' do
+    with_concat_form_for(@user) do |f|
+      f.input_field :status, :collection => ['Open', 'Closed'], :class => 'status', :label_method => :to_s, :value_method => :to_s
+    end
+
+    assert_no_select 'select.status[input_html]'
+    assert_no_select 'select.status[collection]'
+    assert_no_select 'select.status[label_method]'
+    assert_no_select 'select.status[value_method]'
+  end
+end

data/test/form_builder/label_test.rb

@@ -0,0 +1,65 @@
+# encoding: UTF-8
+require 'test_helper'
+
+class LabelTest < ActionView::TestCase
+  def with_label_for(object, *args, &block)
+    with_concat_form_for(object) do |f|
+      f.label(*args, &block)
+    end
+  end
+
+  test 'builder should generate a label for the attribute' do
+    with_label_for @user, :name
+    assert_select 'label.string[for=user_name]', /Name/
+  end
+
+  test 'builder should generate a label componet tag with a clean HTML' do
+    with_label_for @user, :name
+    assert_no_select 'label.string[label_html]'
+  end
+
+  test 'builder should add a required class to label if the attribute is required' do
+    with_label_for @validating_user, :name
+    assert_select 'label.string.required[for=validating_user_name]', /Name/
+  end
+
+  test 'builder should allow passing options to label tag' do
+    with_label_for @user, :name, :label => 'My label', :id => 'name_label'
+    assert_select 'label.string#name_label', /My label/
+  end
+
+  test 'builder label should generate label tag with clean HTML' do
+    with_label_for @user, :name, :label => 'My label', :required => true, :id => 'name_label'
+    assert_select 'label.string#name_label', /My label/
+    assert_no_select 'label[label]'
+    assert_no_select 'label[required]'
+  end
+
+  test 'builder should not modify the options hash' do
+    options = { :label => 'My label', :id => 'name_label' }
+    with_label_for @user, :name, options
+    assert_select 'label.string#name_label', /My label/
+    assert_equal({ :label => 'My label', :id => 'name_label' }, options)
+  end
+
+  test 'builder should fallback to default label when string is given' do
+    with_label_for @user, :name, 'Nome do usuário'
+    assert_select 'label', 'Nome do usuário'
+    assert_no_select 'label.string'
+  end
+
+  test 'builder should fallback to default label when block is given' do
+    with_label_for @user, :name do
+      'Nome do usuário'
+    end
+    assert_select 'label', 'Nome do usuário'
+    assert_no_select 'label.string'
+  end
+
+  test 'builder allows label order to be changed' do
+    swap SimpleForm, :label_text => lambda { |l, r| "#{l}:" } do
+      with_label_for @user, :age
+      assert_select 'label.integer[for=user_age]', "Age:"
+    end
+  end
+end