Merge branch 'develop' of github.com:basemate/matestack-ui-core into develop

Author: pascalwengerter

app/concepts/matestack/ui/core/dfn/dfn.haml

@@ -0,0 +1,5 @@
+%dfn{@tag_attributes}
+  - if options[:text].nil? && block_given?
+    = yield
+  - else
+    = options[:text]

app/concepts/matestack/ui/core/dfn/dfn.rb

@@ -0,0 +1,6 @@
+module Matestack::Ui::Core::Dfn
+  class Dfn < Matestack::Ui::Core::Component::Static
+    
+  end
+end
+    

docs/components/dfn.md

@@ -0,0 +1,49 @@
+# matestack core component: Hr
+
+Show [specs](/spec/usage/components/dfn_spec.rb)
+
+The HTML `<dfn>` tag implemented in ruby.
+
+## Parameters
+
+This component can take 2 optional configuration params.
+
+#### # id (optional)
+Expects a string with all ids the dfn should have.
+
+#### # class (optional)
+Expects a string with all classes the dfn should have.
+
+## Example 1
+Adding an optional id
+
+```ruby
+div id: "foo", class: "bar" do
+  dfn id: "dfn-id"
+end
+```
+
+returns
+
+```html
+<div id="foo" class="bar">
+  <dfn id="dfn-id">
+</div>
+```
+
+## Example 2
+Adding an optional class
+
+```ruby
+div id: "foo", class: "bar" do
+  dfn class: "dfn-class"
+end
+```
+
+returns
+
+```html
+<div id="foo" class="bar">
+  <dfn class="dfn-class">
+</div>
+```

spec/usage/components/dfn_spec.rb

@@ -0,0 +1,66 @@
+require_relative "../../support/utils"
+include Utils
+
+describe 'dfn Component', type: :feature, js: true do
+
+  it 'Example 1 - yield, no options[:text]' do
+
+    class ExamplePage < Matestack::Ui::Page
+
+      def response
+        components {
+          # simple dfn
+          dfn do
+            plain 'I am simple'
+          end
+
+          # enhanced dfn
+          dfn id: 'my-id', class: 'my-class' do
+            plain 'I am enhanced'
+          end
+        }
+      end
+
+    end
+
+    visit '/example'
+
+    static_output = page.html
+
+    expected_static_output = <<~HTML
+    <dfn>I am simple</dfn>
+    <dfn id="my-id" class="my-class">I am enhanced</dfn>
+    HTML
+
+    expect(stripped(static_output)).to include(stripped(expected_static_output))
+  end
+
+  it 'Example 2 - render options[:text]' do
+
+    class ExamplePage < Matestack::Ui::Page
+
+      def response
+        components {
+          # simple dfn
+          dfn text: 'I am simple'
+
+          # enhanced dfn
+          dfn id: 'my-id', class: 'my-class', text: 'I am enhanced'
+        }
+      end
+
+    end
+
+    visit '/example'
+
+    static_output = page.html
+
+    expected_static_output = <<~HTML
+    <dfn>I am simple</dfn>
+    <dfn id="my-id" class="my-class">I am enhanced</dfn>
+    HTML
+
+    expect(stripped(static_output)).to include(stripped(expected_static_output))
+  end
+
+end