railsstrap 3.3.4 → 4.0.0.beta2

data/spec/rails/form/check_box_helper_spec.rb

@@ -0,0 +1,112 @@
+require 'rails_helper'
+require 'railsstrap/core_ext/rails/form_for_helper'
+include Railsstrap::Rails::Helpers
+
+describe 'check_box' do
+  attr_accessor :output_buffer
+  let(:protect_against_forgery?) { false }
+  let(:form) { form_for user, layout: layout, errors: errors, url: '/', &block }
+  let(:user) { User.new }
+  let(:errors) { {} }
+  let(:block) { Proc.new {|f| f.check_box :name, options} }
+  let(:options) { {} }
+
+  context 'given any layout' do
+    let(:layout) { :whatever }
+
+    specify 'not given a label option, automatically generates one' do
+      expect(form).to include 'Name</label>'
+    end
+
+    context 'given a label option, uses the provided one' do
+      let(:options) { {label: 'Given name'} }
+      it { expect(form).to include 'Given name</label>' }
+    end
+
+    context 'not given a help option, does not display a help box' do
+      it { expect(form).not_to include 'help-block' }
+    end
+
+    context 'given a help option, displays a help box' do
+      let(:options) { {help: 'Please select an option'} }
+      it { expect(form).to include '<span class="help-block text-left">Please select an option</span>' }
+    end
+
+    specify 'not given an error, does not apply has-error to the form group' do
+      expect(form).not_to include 'has-error'
+    end
+
+    context 'given an error' do
+      before { user.errors.add :name, 'cannot be nil' }
+
+      specify 'shows errors and error messages' do
+        expect(form).to include 'has-error'
+        expect(form).to include '<span class="help-block text-left">cannot be nil</span>'
+      end
+    end
+  end
+
+  describe 'given a basic layout' do
+    let(:layout) { :basic }
+    specify 'applies checkbox to the container, and an inline label' do
+      expect(form).to match %r{<div class="checkbox"><label><input.+? /> Name</label></div>}
+    end
+
+    context 'given the inline_label: false option' do
+      let(:options) { {inline_label: false} }
+
+      specify 'aligns the label on top of the check-box' do
+        expect(form).to match %r{<label for="user_name">Name</label><input}
+        expect(form).to include 'input class="form-control"'
+      end
+    end
+  end
+
+  describe 'given a horizontal layout' do
+    let(:layout) { :horizontal }
+    specify 'applies form-group to the outer container, .col-sm-offset-3.col-sm-9 to the field container, checkbox to the container, and an inline label' do
+      expect(form).to match %r{<div class="form-group"><div class="col-sm-offset-3 col-sm-9"><div class="checkbox"><label><input.+? /> Name</label></div></div></div>}
+    end
+
+    context 'given the inline_label: false option' do
+      let(:options) { {inline_label: false} }
+
+      specify 'aligns the label on top of the check-box' do
+        expect(form).to match %r{<label class="col-sm-3 control-label" for="user_name">Name</label><div class="col-sm-9"><input}
+        expect(form).to include 'input class="form-control checkbox"'
+      end
+    end
+  end
+
+  describe 'given an inline layout' do
+    let(:layout) { :inline }
+    specify 'applies checkbox to the container, and an inline label' do
+      expect(form).to match %r{<div class="checkbox"><label><input.+? /> Name</label></div>}
+    end
+
+    context 'given an error' do
+      before { user.errors.add :name, 'cannot be nil' }
+
+      specify 'applies sr-only to the error message' do
+        expect(form).to include '<span class="help-block text-left sr-only">cannot be nil</span>'
+      end
+    end
+
+    context 'given a help message' do
+      let(:options) { {help: 'Please select an option'} }
+
+      specify 'applies sr-only to the help message' do
+        expect(form).to include '<span class="help-block text-left sr-only">Please select an option</span>'
+      end
+    end
+
+    context 'given the inline_label: false option' do
+      let(:options) { {inline_label: false} }
+
+      specify 'aligns the label on top of the check-box' do
+        expect(form).to match %r{<label class="sr-only" for="user_name">Name</label><input}
+        expect(form).not_to include 'form-control'
+      end
+    end
+  end
+end

data/spec/rails/form/field_helper_spec.rb

@@ -0,0 +1,138 @@
+require 'rails_helper'
+require 'railsstrap/core_ext/rails/form_for_helper'
+include Railsstrap::Rails::Helpers
+
+def self.field_helpers_to_test
+  types = %w(email number password phone search telephone text url)
+  if defined?(ActionView::VERSION) # only defined in ActionView >=4
+    # types.concat %w(color date datetime datetime_local month time week)
+  end
+  types.map{|type| "#{type}_field"} << "text_area"
+end
+
+field_helpers_to_test.each do |form_field|
+  describe form_field do
+    attr_accessor :output_buffer
+    let(:protect_against_forgery?) { false }
+    let(:form) { form_for user, layout: layout, errors: errors, url: '/', &block }
+    let(:user) { User.new }
+    let(:errors) { {} }
+
+    let(:block) { Proc.new {|f| f.send form_field, :name, options} }
+    let(:options) { {} }
+
+    context 'given any layout' do
+      let(:layout) { :whatever }
+
+      specify 'not given a placeholder option, automatically generates one' do
+        expect(form).to include 'placeholder="Name"'
+      end
+
+      context 'given a placeholder option, uses the provided one' do
+        let(:options) { {placeholder: 'Given name'} }
+        it { expect(form).to include 'placeholder="Given name"' }
+      end
+
+      specify 'not given a label option, automatically generates one' do
+        expect(form).to include 'Name</label>'
+      end
+
+      context 'given a label option, uses the provided one' do
+        let(:options) { {label: 'Given name'} }
+        it { expect(form).to include 'Given name</label>' }
+      end
+
+      context 'not given a help option, does not display a help box' do
+        it { expect(form).not_to include 'help-block' }
+      end
+
+      context 'given a help option, displays a help box' do
+        let(:options) { {help: 'Please write the given name'} }
+        it { expect(form).to include '<span class="help-block text-left">Please write the given name</span>' }
+      end
+
+      specify 'not given a prefix or suffix option, does not use an input group' do
+        expect(form).not_to include 'input-group'
+      end
+
+      context 'given a prefix option, prints the prefix before the field' do
+        let(:options) { {prefix: 'Mr.'} }
+        it { expect(form).to include '<div class="input-group"><span class="input-group-addon">Mr.</span><' }
+      end
+
+      context 'given a suffix option, prints the prefix after the field' do
+        let(:options) { {suffix: 'Jr'} }
+        it { expect(form).to match %r{<div class="input-group"><.+?><span class="input-group-addon">Jr</span></div>}m }
+      end
+
+      specify 'not given an error, does not apply has-error to the form group' do
+        expect(form).not_to include 'has-error'
+      end
+
+      context 'given an error' do
+        before { user.errors.add :name, 'cannot be nil' }
+
+        specify 'shows errors and error messages' do
+          expect(form).to include 'has-error'
+          expect(form).to include '<span class="help-block text-left">cannot be nil</span>'
+        end
+
+        specify 'shows error icons (except for number_field)' do
+          expect(form).to include 'has-feedback' unless form_field == 'number_field'
+        end
+
+        context 'given an option to hide error icons, hides error icons' do
+          let(:errors) { {icons: false} }
+          it{ expect(form).not_to include 'has-feedback' }
+        end
+
+        context 'given the suffix option, hides error icons (or they would overlap)' do
+          let(:options) { {suffix: 'Jr'} }
+          it{ expect(form).not_to include 'form-control-feedback' }
+        end
+
+        context 'given an option to hide error messages, hides error messages' do
+          let(:errors) { {messages: false} }
+          it{ expect(form).not_to include 'help-block' }
+        end
+      end
+    end
+
+    describe 'given a basic layout' do
+      let(:layout) { :basic }
+      specify 'applies form-group to the container, form-control to the input' do
+        expect(form).to match %r{<div class="form-group"><label.+?>Name</label><(input|textarea)(?:| placeholder="Name") class="form-control"}
+      end
+    end
+
+    describe 'given a horizontal layout' do
+      let(:layout) { :horizontal }
+      specify 'applies form-group to the container, form-control to the input, col-sm-3.control-label to the label and col-sm-9 to the field container' do
+        expect(form).to match %r{<div class="form-group"><label class="col-sm-3 control-label".+?>Name</label><div class="col-sm-9"><(input|textarea)(?:| placeholder="Name") class="form-control"}
+      end
+    end
+
+    describe 'given an inline layout' do
+      let(:layout) { :inline }
+      specify 'applies form-group to the container, form-control to the input, sr-only to the label' do
+        expect(form).to match %r{<div class="form-group"><label class="sr-only".+?>Name</label><(input|textarea)(?:| placeholder="Name") class="form-control"}
+      end
+
+      context 'given a help message' do
+        let(:options) { {help: 'Please write the given name'} }
+
+        specify 'applies sr-only to the help message' do
+          expect(form).to include '<span class="help-block text-left sr-only">Please write the given name</span>'
+        end
+      end
+
+      context 'given an error' do
+        before { user.errors.add :name, 'cannot be nil' }
+
+        specify 'applies sr-only to the error message' do
+          expect(form).to include '<span class="help-block text-left sr-only">cannot be nil</span>'
+        end
+      end
+    end
+  end
+end

data/spec/rails/form/fields_for_helper_spec.rb

@@ -0,0 +1,65 @@
+require 'rails_helper'
+require 'railsstrap/core_ext/rails/form_for_helper'
+include Railsstrap::Rails::Helpers
+
+describe 'fields_for' do
+  let(:protect_against_forgery?) { false }
+  let(:form) { form_for user, layout: layout, url: '/', &block }
+  let(:user) { User.new }
+  let(:layout) { :whatever }
+  let(:block) { Proc.new {|f| f.fields_for :address, options, &fields_block } }
+  let(:options) { {} }
+  let(:title) { nil }
+  let(:fields_block) { Proc.new {|f| f.text_field :street } }
+
+  describe 'with the :fieldset option' do
+    specify 'not set, wraps the fields in a <fieldset> styled like a card' do
+      expect(form).to match %r{.*fieldset.*class="card bg-default">.*}
+    end
+
+    describe 'set to true, wraps the fields in a <fieldset> styled like a card' do
+      let(:options) { {fieldset: true} }
+      it { expect(form).to match %r{.*fieldset.*class="card bg-default">.*} }
+    end
+
+    describe 'set to false, does not wrap the fields in a <fieldset>' do
+      let(:options) { {fieldset: false} }
+      it { expect(form).not_to include 'fieldset' }
+    end
+  end
+
+  describe 'with the :title option' do
+    specify 'not set, generates a title from the field name' do
+      expect(form).to include '<div class="card-header">Address</div>'
+    end
+
+    context 'set to a value, uses the value as the card title' do
+      let(:options) { {title: 'Your address'} }
+      it { expect(form).to include '<div class="card-header">Your address</div>' }
+    end
+  end
+
+  describe 'with the :layout option' do
+    specify 'not set, inherits the layout options of the parent form' do
+      expect(form).to match %r{<div class="form-group"><label for.+?>Street</label>}
+    end
+
+    context 'set to a value, uses the value as the layout' do
+      let(:options) { {layout: :horizontal} }
+      it { expect(form).to match %r{<div class="form-group"><label class="col-sm-3 control-label" for.+?>Street</label>} }
+    end
+  end
+
+  context 'given a record object' do
+    let(:block) { Proc.new {|f| f.fields_for :address, user.name, options, &fields_block } }
+
+    specify 'and no other options, uses the provided record object' do
+      expect(form).to match %r{.*fieldset.*class="card bg-default">.*}
+    end
+
+    context 'and other options, uses the provided record object and options' do
+      let(:options) { {title: 'Your address'} }
+      it { expect(form).to include '<div class="card-header">Your address</div>' }
+    end
+  end
+end

data/spec/rails/form/fieldset_helper_spec.rb

@@ -0,0 +1,32 @@
+require 'rails_helper'
+require 'railsstrap/core_ext/rails/form_for_helper'
+include Railsstrap::Rails::Helpers
+
+describe 'fieldset' do
+  let(:protect_against_forgery?) { false }
+  let(:form) { form_for User.new, layout: layout, url: '/', &block }
+  let(:block) { Proc.new {|f| f.fieldset title, &fieldset_block } }
+  let(:title) { nil }
+  let(:fieldset_block) { Proc.new { 'fieldset content' } }
+  let(:layout) { :whatever }
+
+  specify 'adds a <fieldset> that looks like a Bootstrap card' do
+    expect(form).to include 'fieldset class="card bg-default">'
+  end
+
+  context 'given a title, and a non-inline layout, adds the title in the card header' do
+    let(:title) { 'Info' }
+    it { expect(form).to include '<div class="card-header">Info</div>' }
+  end
+
+  context 'given a title, and an inline layout, does not add a card header' do
+    let(:layout) { :inline }
+    let(:title) { 'Info' }
+    it { expect(form).not_to include '<div class="card-header">Info</div>' }
+  end
+
+  context 'not given a title, does not add a card header' do
+    let(:title) { '' }
+    it { expect(form).not_to include 'card-header' }
+  end
+end

data/spec/rails/form/file_field_helper_spec.rb

@@ -0,0 +1,74 @@
+require 'rails_helper'
+require 'railsstrap/core_ext/rails/form_for_helper'
+include Railsstrap::Rails::Helpers
+
+describe 'file_field' do
+  let(:protect_against_forgery?) { false }
+  let(:form) { form_for user, layout: layout, errors: errors, url: '/', &block }
+  let(:user) { User.new }
+  let(:errors) { {} }
+  let(:block) { Proc.new {|f| f.file_field :name, options.merge(accept: 'text/html')} }
+  let(:options) { {} }
+
+  context 'given any layout' do
+    let(:layout) { :whatever }
+
+    context 'not given a help option, does not display a help box' do
+      it { expect(form).not_to include 'help-block' }
+    end
+
+    context 'given a help option, displays a help box' do
+      let(:options) { {help: 'Please upload a file'} }
+      it { expect(form).to include '<span class="help-block text-left">Please upload a file</span>' }
+    end
+  end
+
+  describe 'given a basic layout' do
+    let(:layout) { :basic }
+    specify 'applies form-group to the container to the input' do
+      expect(form).to match %r{<div class="form-group"><label.+?>Name</label><(input|textarea)}
+    end
+
+    specify 'does not apply form-control to the input' do
+      expect(form).not_to match 'form-control'
+    end
+  end
+
+  describe 'given a horizontal layout' do
+    let(:layout) { :horizontal }
+    specify 'applies form-group to the container, col-sm-3.control-label to the label and col-sm-9 to the field container' do
+      expect(form).to match %r{<div class="form-group"><label class="col-sm-3 control-label".+?>Name</label><div class="col-sm-9"><(input|textarea)}
+    end
+
+    specify 'does not apply form-control to the input' do
+      expect(form).not_to match 'form-control'
+    end
+  end
+
+  describe 'given an inline layout' do
+    let(:layout) { :inline }
+    specify 'applies form-group to the container, sr-only to the label' do
+      expect(form).to match %r{<div class="form-group"><label class="sr-only".+?>Name</label><(input|textarea)}
+    end
+
+    specify 'does not apply form-control to the input' do
+      expect(form).not_to match 'form-control'
+    end
+
+    context 'given a help message' do
+      let(:options) { {help: 'Please select a file'} }
+
+      specify 'applies sr-only to the help message' do
+        expect(form).to include '<span class="help-block text-left sr-only">Please select a file</span>'
+      end
+    end
+
+    context 'given an error' do
+      before { user.errors.add :name, 'cannot be nil' }
+
+      specify 'applies sr-only to the error message' do
+        expect(form).to include '<span class="help-block text-left sr-only">cannot be nil</span>'
+      end
+    end
+  end
+end

data/spec/rails/form/legend_helper_spec.rb

@@ -0,0 +1,35 @@
+require 'rails_helper'
+require 'railsstrap/core_ext/rails/form_for_helper'
+include Railsstrap::Rails::Helpers
+
+describe 'legend' do
+  let(:protect_against_forgery?) { false }
+  let(:form) { form_for User.new, layout: layout, url: '/', &block }
+  let(:block) { Proc.new {|f| f.legend 'Basic info' } }
+  let(:layout) { :whatever }
+
+  specify 'adds a <legend> to the form' do
+    expect(form).to include 'legend'
+  end
+
+  describe 'given a basic layout' do
+    let(:layout) { :basic }
+    specify 'applies form-group to the container' do
+      expect(form).to match %r{<div class="form-group"><legend>Basic info</legend></div>}
+    end
+  end
+
+  describe 'given a horizontal layout' do
+    let(:layout) { :horizontal }
+    specify 'applies form-group to the container, col-sm-12 to the field container' do
+      expect(form).to match %r{<div class="form-group"><div class="col-sm-12"><legend>Basic info</legend></div>}
+    end
+  end
+
+  describe 'given an inline layout' do
+    let(:layout) { :inline }
+    specify 'applies sr-only to the legend' do
+      expect(form).to match %r{<legend class="sr-only">Basic info</legend>}
+    end
+  end
+end