railsstrap 3.3.4 → 4.0.0.beta2

data/spec/shared/dropdown_helper.rb

@@ -0,0 +1,112 @@
+shared_examples_for 'the dropdown helper' do
+  all_tests_pass_with 'no dropdown options'
+  all_tests_pass_with 'the :id dropdown option'
+  all_tests_pass_with 'the :variant dropdown option'
+  all_tests_pass_with 'the :size dropdown option'
+  all_tests_pass_with 'the :layout dropdown option'
+  all_tests_pass_with 'the :groupable dropdown option'
+  all_tests_pass_with 'the :direction dropdown option'
+  all_tests_pass_with 'the :align dropdown option'
+  all_tests_pass_with 'the :split dropdown option'
+  all_tests_pass_with 'the button: :class dropdown option'
+end
+
+#--
+
+shared_examples_for 'no dropdown options' do
+  specify 'displays a button with the caption and the caret to toggle a menu' do
+    html = <<-EOT.strip_heredoc.strip
+      <div class="btn-group">
+        <button class="dropdown-toggle btn btn-primary" type="button" id="(.+)" data-toggle="dropdown">
+          caption
+          <span class=\"caret\"><\/span>
+        <\/button>
+        <ul class=\"dropdown-menu\" role=\"menu\" aria-labelledby=\"\\1\">
+          content
+        <\/ul>
+      <\/div>
+    EOT
+    expect(:dropdown).to generate %r{#{html}}
+  end
+end
+
+shared_examples_for 'the :id dropdown option' do
+  specify 'uses the ID to connect button and ul' do
+    id = 'my-modal'
+    expect(dropdown: {id: id}).to generate %r{<button.+id="#{id}".*>}
+    expect(dropdown: {id: id}).to generate %r{<ul.+aria-labelledby="#{id}".*>}
+  end
+end
+
+shared_examples_for 'the :variant dropdown option' do
+  Railsstrap::Button.variants.each do |variant, variant_class|
+    specify %Q{set to :#{variant}, adds the class "#{variant_class}"} do
+      html = %r{<button class="dropdown-toggle btn #{variant_class}"}
+      expect(dropdown: {variant: variant}).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the :size dropdown option' do
+  Railsstrap::Button.sizes.each do |size, size_class|
+    specify %Q{set to :#{size}, adds the class "#{size_class}"} do
+      html = %r{<button class="dropdown-toggle btn btn-primary #{size_class}"}
+      expect(dropdown: {size: size}).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the :layout dropdown option' do
+  Railsstrap::Button.layouts.each do |layout, layout_class|
+    specify %Q{set to :#{layout}, adds the class "#{layout_class}"} do
+      html = %r{<button class="dropdown-toggle btn btn-primary #{layout_class}"}
+      expect(dropdown: {layout: layout}).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the :groupable dropdown option' do
+  Railsstrap::Dropdown.groupables.each do |groupable, groupable_class|
+    specify %Q{set to :#{groupable}, adds the class "#{groupable_class}"} do
+      html = %r{^<div class="#{groupable_class}">}
+      expect(dropdown: {groupable: groupable}).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the :direction dropdown option' do
+  Railsstrap::Dropdown.directions.each do |direction, direction_class|
+    specify %Q{set to :#{direction}, adds the class "#{direction_class}"} do
+      html = %r{^<div class="btn-group #{direction_class}">}
+      expect(dropdown: {direction: direction}).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the :align dropdown option' do
+  Railsstrap::Dropdown.aligns.each do |align, align_class|
+    specify %Q{set to :#{align}, adds the class "#{align_class}"} do
+      html = %r{<ul class="dropdown-menu #{align_class}" role="menu"}
+      expect(dropdown: {align: align}).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the :split dropdown option' do
+  html = %r{<button type="button" class="btn btn-primary">caption</button>}
+
+  specify %Q{set to truthy, splits the caption and the caret} do
+    expect(dropdown: {split: true}).to generate html
+  end
+
+  specify %Q{set to falsey, does not split the caption and the caret} do
+    expect(dropdown: {split: false}).not_to generate html
+  end
+end
+
+shared_examples_for 'the button: :class dropdown option' do
+  specify 'appends the class to the modal button' do
+    html = %r{<button class="dropdown-toggle important btn btn-primary"}
+    expect(dropdown: {button: {class: 'important'}}).to generate html
+  end
+end

data/spec/shared/glyphicon_helper.rb

@@ -0,0 +1,21 @@
+shared_examples_for 'the glyphicon helper' do
+  all_tests_pass_with 'no glyphicon options'
+  all_tests_pass_with 'extra glyphicon options'
+end
+
+#--
+
+shared_examples_for 'no glyphicon options' do
+  specify 'creates a <i> with an icon' do
+    html = '<i class="glyphicon glyphicon-zoom-in"></i>'
+    expect(glyphicon: :zoom_in).to generate html
+  end
+end
+
+shared_examples_for 'extra glyphicon options' do
+  specify 'passes the options to the <span>' do
+    options = {name: :zoom_in, tag: :span, class: 'important', data: {value: 1}, id: 'my-glyphicon'}
+    html = '<span class="important glyphicon glyphicon-zoom-in" data-value="1" id="my-glyphicon"></span>'
+    expect(glyphicon: options).to generate html
+  end
+end

data/spec/shared/horizontal_helper.rb

@@ -0,0 +1,37 @@
+shared_examples_for 'the horizontal helper' do
+  all_tests_pass_with 'the horizontal not wrapped in navbar'
+  all_tests_pass_with 'no horizontal options'
+  all_tests_pass_with 'extra horizontal options (except :id)'
+  all_tests_pass_with 'the horizontal wrapped in a navbar with :id'
+end
+
+#--
+
+shared_examples_for 'the horizontal not wrapped in navbar' do
+  specify 'returns nil' do
+    expect(:horizontal).to generate nil
+  end
+end
+
+shared_examples_for 'no horizontal options' do
+  specify 'creates a <div class="collpase navbar-collapse"> element' do
+    html = %r{<div class="collapse navbar-collapse" id=".+">content</div>}
+    railsstrap.navbar { expect(:horizontal).to generate html }
+  end
+end
+
+shared_examples_for 'extra horizontal options (except :id)' do
+  specify 'passes the options to the <div> element' do
+    options = {class: 'important', data: {value: 1}}
+    html = %r{<div class="important collapse navbar-collapse" data-value="1"}
+    railsstrap.navbar { expect(horizontal: options).to generate html }
+  end
+end
+
+shared_examples_for 'the horizontal wrapped in a navbar with :id' do
+  it 'uses the id from the navbar' do
+    id = 'my-navbar'
+    html = %r{<div class="collapse navbar-collapse" id="my-navbar">content</div>}
+    railsstrap.navbar(id: id) { expect(:horizontal).to generate html}
+  end
+end

data/spec/shared/icon_helper.rb

@@ -0,0 +1,31 @@
+shared_examples_for 'the icon helper' do
+  all_tests_pass_with 'no icon options'
+  all_tests_pass_with 'extra icon options'
+  all_tests_pass_with 'the :library icon option'
+end
+
+#--
+
+shared_examples_for 'no icon options' do
+  specify 'creates a <i> with an icon' do
+    html = '<i class="far fa-zoom-in"></i>'
+    expect(:icon).to generate html
+  end
+end
+
+shared_examples_for 'extra icon options' do
+  specify 'passes the options to the <i>' do
+    options = {name: :zoom_in, class: 'important', data: {value: 1}, id: 'my-icon'}
+    html = '<i class="important far fa-zoom-in" data-value="1" id="my-icon"></i>'
+    expect(icon: options).to generate html
+  end
+end
+
+shared_examples_for 'the :library icon option' do
+  Railsstrap::Icon.libraries.each do |library, library_class|
+    specify %Q{set to :#{library}, adds the class "#{library_class}"} do
+      html = %r{<i class="#{library_class}.*}
+      expect(icon: {library: library}).to generate html
+    end
+  end
+end

data/spec/shared/link_to_helper.rb

@@ -0,0 +1,84 @@
+shared_examples_for 'the link_to helper' do
+  all_tests_pass_with 'no link_to options'
+  all_tests_pass_with 'extra link_to options'
+  all_tests_pass_with 'the link wrapped in alert_box'
+  all_tests_pass_with 'the link wrapped in dropdown'
+  all_tests_pass_with 'the link wrapped in nav'
+  all_tests_pass_with 'the link wrapped in vertical'
+  all_tests_pass_with 'the link including unsafe Javascript'
+  all_tests_pass_with 'the link including safe HTML content'
+end
+
+#--
+
+shared_examples_for 'no link_to options' do
+  specify 'matches the behavior of the framework-defined link_to' do
+    html = '<a href="/">content</a>'
+    expect(:link_to).to generate html
+  end
+end
+
+shared_examples_for 'extra link_to options' do
+  specify 'passes the options to the <a>' do
+    options = {class: 'important', data: {value: 1}, id: 'my-link'}
+    html = %r{^<a.+class="important" data-value="1".+id="my-link".*>content</a>$}
+    expect(link_to: options).to generate html
+  end
+end
+
+shared_examples_for 'the link wrapped in alert_box' do
+  specify 'adds the "alert-link" class to the link' do
+    html = %r{(.*)class="(.*)alert-link(.*)">.*}
+    railsstrap.alert_box { expect(:link_to).to generate html }
+  end
+end
+
+shared_examples_for 'the link wrapped in dropdown' do
+  specify 'surrounds the link in a <li> and adds role and tabindex' do
+    html = %r{<li role="presentation"><a.+role="menuitem" tabindex="-1".*>content</a></li>}
+    railsstrap.dropdown('') { expect(:link_to).to generate html }
+  end
+end
+
+shared_examples_for 'the link wrapped in nav' do
+  specify 'surrounds the link in a <li> item' do
+    html = %r{^<li class="nav-item"><a(.*)class="nav-link"(.*)}m
+    railsstrap.nav { expect(:link_to).to generate html }
+  end
+
+  describe 'if the link is to the current page' do
+    before { allow_any_instance_of(Railsstrap::LinkTo).to receive(:current_page?).and_return true }
+
+    specify 'surrounds the link in a <li class="active"> item' do
+      html = %r{(class="active.*")}
+      railsstrap.nav { expect(:link_to).to generate html }
+    end
+  end
+end
+
+shared_examples_for 'the link wrapped in vertical' do
+  specify 'adds the "navbar-brand" class to the link' do
+    html = %r{^<a.+class="navbar-brand".*>content</a>$}
+    railsstrap.navbar(id: 'id') do
+      railsstrap.vertical { expect(:link_to).to generate html }
+    end
+  end
+end
+
+shared_examples_for 'the link including unsafe Javascript' do
+  specify 'uses the original link_to helper which escapes the link' do
+    expect(link_to: :xss_script).not_to generate %r{<script>}
+    railsstrap.alert_box { expect(link_to: :xss_script).not_to generate %r{<script>} }
+    railsstrap.dropdown('') { expect(link_to: :xss_script).not_to generate %r{<script>} }
+    railsstrap.nav { expect(link_to: :xss_script).not_to generate %r{<script>} }
+    railsstrap.navbar(id: 'id') do
+      railsstrap.vertical { expect(link_to: :xss_script).not_to generate %r{<script>} }
+    end
+  end
+end
+
+shared_examples_for 'the link including safe HTML content' do
+  specify 'does not escape the HTML content' do
+    expect(link_to: :safe_html).to generate %r{<hr />}
+  end
+end

data/spec/shared/modal_helper.rb

@@ -0,0 +1,96 @@
+shared_examples_for 'the modal helper' do
+  all_tests_pass_with 'no modal options'
+  all_tests_pass_with 'the :id modal option'
+  all_tests_pass_with 'the :body modal option'
+  all_tests_pass_with 'the :title modal option'
+  all_tests_pass_with 'the :size modal option'
+  all_tests_pass_with 'the button: :caption modal option'
+  all_tests_pass_with 'the button: :variant modal option'
+  all_tests_pass_with 'the button: :size modal option'
+  all_tests_pass_with 'the button: :class modal option'
+end
+
+#--
+
+shared_examples_for 'no modal options' do
+  specify 'sets the role and the class to "modal", uses a generated ID and uses "Modal" as the title and caption' do
+    html = %r{(div.*class="modal.+").*(id="modal-(.*[0-9])").+(role="dialog")}
+    expect(:modal).to generate %r{#{html}}
+  end
+end
+
+shared_examples_for 'the :id modal option' do
+  specify 'uses the ID to connect button and modal' do
+    id = 'my-modal'
+    expect(modal: {id: id}).to generate %r{<button.+data-target="##{id}">Modal<\/button>}
+    expect(modal: {id: id}).to generate %r{<div.+id="#{id}".+aria-labelledby="label-#{id}".+>}
+    expect(modal: {id: id}).to generate %r{<h4.+id="label-#{id}">Modal<\/h4>}
+  end
+end
+
+shared_examples_for 'the :body modal option' do
+  let(:html) { %r{<div class="modal-body">Body</div>} }
+
+  specify 'given either a content or a block, is ignored' do
+    expect(modal: {body: 'Body'}).not_to generate html
+  end
+
+  specify 'given neither content nor a block, it is displayed as the content' do
+    expect(railsstrap.modal(body: 'Body')).to match html
+  end
+end
+
+shared_examples_for 'the :title modal option' do
+  specify 'sets the modal title to the given value' do
+    html = %r{<h4 class="modal-title".+>Title</h4>}
+    expect(modal: {title: 'Title'}).to generate html
+  end
+end
+
+shared_examples_for 'the :size modal option'do
+  Railsstrap::Modal.dialog_sizes.each do |size, size_class|
+    specify %Q{set to :#{size}, adds the class "#{size_class}"}  do
+      html = %r{<div class="modal-dialog #{size_class}">}
+      expect(modal: {size: size}).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the button: :caption modal option' do
+  specify 'sets the button caption to the given value' do
+    html = %r{<button.+>Click me</button>}
+    expect(modal: {button: {caption: 'Click me'}}).to generate html
+  end
+end
+
+shared_examples_for 'the button: :variant modal option' do
+  Railsstrap::Button.variants.each do |variant, variant_class|
+    specify %Q{set to :#{variant}, adds the class "#{variant_class}"} do
+      html = %r{<button class="btn #{variant_class}"}
+      expect(modal: {button: {variant: variant}}).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the button: :size modal option' do
+  Railsstrap::Button.sizes.each do |size, size_class|
+    specify %Q{set to :#{size}, adds the class "#{size_class}"} do
+      html = %r{<button class="btn btn-primary #{size_class}"}
+      expect(modal: {button: {size: size}}).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the button: :class modal option' do
+  specify 'appends the class to the modal button' do
+    html = %r{<button class="important btn btn-primary"}
+    expect(modal: {button: {class: 'important'}}).to generate html
+  end
+end
+
+shared_examples_for 'the :dismissable modal option' do
+  specify 'renders the dismissable button on the modal button' do
+    html = %r{.*(class="close").*(dismiss="modal")}
+    expect(modal: {dismissible: true, dismiss: :modal}).to generate html
+  end
+end

data/spec/shared/nav_helper.rb

@@ -0,0 +1,49 @@
+shared_examples_for 'the nav helper' do
+  all_tests_pass_with 'no nav options'
+  all_tests_pass_with 'extra nav options'
+  all_tests_pass_with 'the :as nav option'
+  all_tests_pass_with 'the :layout nav option'
+  all_tests_pass_with 'the nav wrapped in navbar'
+end
+
+#--
+
+shared_examples_for 'no nav options' do
+  specify 'creates a <nav> element with the "navigation" role' do
+    html = %r{<nav.+role="navigation"(.*)<\/nav>}
+    expect(:nav).to generate html
+  end
+end
+
+shared_examples_for 'extra nav options' do
+  specify 'passes the options to the <ul> element' do
+    options = {class: 'important', data: {value: 1}, id: 'my-alert'}
+    html = %r{(important).*(data-value="1").*(id="my-alert")}
+    expect(nav: options).to generate html
+  end
+end
+
+shared_examples_for 'the :as nav option' do
+  Railsstrap::Nav.styles.each do |style, style_class|
+    specify %Q{set to :#{context}, sets the class "#{style_class}"} do
+      html = %r{<nav class="nav #{style_class}"}
+      expect(nav: {as: style}).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the :layout nav option' do
+  Railsstrap::Nav.layouts.each do |layout, layout_class|
+    specify %Q{set to :#{layout}, adds the class "#{layout_class}"} do
+      html = %r{<nav class="nav #{layout_class}"}
+      expect(nav: {layout: layout}).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the nav wrapped in navbar' do
+  specify 'creates a <nav> element with the "navbar-nav" class' do
+    html = %r{<nav.*(role="navigation")*(class="nav navbar-nav").+<\/nav>}
+    railsstrap.navbar { expect(:nav).to generate html }
+  end
+end

data/spec/shared/navbar_helper.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+shared_examples_for 'the navbar helper' do
+  all_tests_pass_with 'no navbar options'
+  all_tests_pass_with 'the :fluid navbar option'
+  all_tests_pass_with 'the :variant navbar option'
+  all_tests_pass_with 'the :text_variant navbar option'
+  all_tests_pass_with 'the :position navbar option'
+end
+
+#--
+
+shared_examples_for 'no navbar options' do
+  specify 'creates a <nav> element with a nested container' do
+    html = <<-EOT.strip_heredoc.strip
+      <nav class="navbar bg-primary navbar-expand-lg navbar-dark" role="navigation">
+        <div class="container">
+          content
+        </div>
+      </nav>
+    EOT
+    expect(:navbar).to generate html
+  end
+end
+
+shared_examples_for 'the :fluid navbar option' do
+  Railsstrap::Navbar.layouts.each do |value, fluid_class|
+    specify %(set to #{value}, sets the class "#{fluid_class}") do
+      html = /<div class="#{fluid_class}">/
+      expect(navbar: { fluid: value }).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the :variant navbar option' do
+  Railsstrap::Navbar.variants.each do |value, variant_class|
+    specify %(set to #{value}, sets the class "#{variant_class}") do
+      html = /<nav class="navbar #{variant_class}.+/
+      expect(navbar: { variant: value }).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the :text_variant navbar option' do
+  Railsstrap::Navbar.text_variants.each do |value, variant_class|
+    specify %(set to #{value}, sets the class "#{variant_class}") do
+      html = /^<nav class="navbar(.*)navbar-dark(.*)" role="navigation"(.*)/
+      expect(navbar: { variant: value }).to generate html
+    end
+  end
+end
+
+shared_examples_for 'the :position navbar option' do
+  Railsstrap::Navbar.positions.each do |position, position_class|
+    specify %(set to #{position}, sets the class "#{position_class}") do
+      html = /(.*)class=".+#{position_class}"(.*)/
+      expect(navbar: { position: position }).to generate html
+    end
+  end
+end