csedl-stimulus-dropdown 0.0.1 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 44ac5608bddcb791672dfefa6a52bc403acf3a22572290c303dbc46f7eaca64f
-  data.tar.gz: 28470466e6f2d317f3cbbeadcc7e817f99ec92264586d78bbed7414ff21737f8
+  metadata.gz: 9e7fd4091a8b1b4ebdb69ec8beb943dc01cee6818dbe63170038a9cf6af22076
+  data.tar.gz: 397008a25d6c26440055c32c40fd6456eb64e2a4188e26319955789ee8373f4e
 SHA512:
-  metadata.gz: e2c343785a57540605e9f3c77777333ab475e56e547e56639dbe59e4fd68ea1443b867752da7c172e139633efb74d3c30b2ea49e29d8c33691ec9d9be1c6ba9a
-  data.tar.gz: 71988429f909ca509b867e92631ebe065dc903204669b476d3a51a49e2fb85214501929acb65886668bb929fa1f4fd581376d683aa0b74d8033e2536e06ae749
+  metadata.gz: 11a98f6622bac56e69f72d22f6da3d1a644de360a2c109fc1eea9ed87cfdb0d12d4cc5af738d67985d9f4333c4bd3c131af9e3e9df391751d72f590136f3eb69
+  data.tar.gz: 672bceb4b3930f1fca0ff9af4cea2830ce08a34f7a544d8c0b6f5623d53d47cf661ea967e7efbddc2200d59314b5435a660a629f45b1c62cdf44b07cb3c71e28

data/README.md

@@ -0,0 +1,21 @@
+# Stimulus Dropdown
+
+This is nothing else than two view helpers corresponding to the npm package
+[@csedl/stimulus-dropdown](https://www.npmjs.com/package/@csedl/stimulus-dropdown)
+
+You also can just paste this [view helpers](https://gitlab.com/sedl/csedl-stimulus-dropdown/-/blob/main/lib/stimulus_dropdown/view_helpers.rb?ref_type=heads)
+into your app and modify as you want.
+
+If you work with the helpers on this gem, you can setup a initializer for a custom close-button, like: 
+
+```ruby
+#=> config/initializers/csedl_stimulus_dropdown.rb
+
+StimulusDropdown.configure do |config|
+  config.close_button_proc = ->(view) do
+    view.content_tag(:span, 'X', class: 'close-button')
+  end
+end
+```
+
+License: MIT

data/lib/csedl-stimulus-dropdown.rb

@@ -0,0 +1,19 @@
+require "csedl_stimulus_dropdown/railtie" if defined?(Rails)
+require "csedl_stimulus_dropdown/view_helpers"
+
+module StimulusDropdown
+  class << self
+    attr_accessor :close_button_proc
+
+    def configure
+      yield self
+    end
+
+    def reset_config!
+      self.close_button_proc = nil
+    end
+  end
+
+  # Default fallback if no config is set
+  self.close_button_proc = nil
+end

data/lib/csedl_stimulus_dropdown/railtie.rb

@@ -0,0 +1,10 @@
+module CsedlStimulusDropdown
+  class Railtie < Rails::Railtie
+
+    initializer "csedl_stimulus_dropdown.view_helpers" do
+      ActiveSupport.on_load(:action_view) do
+        include CsedlStimulusDropdown::ViewHelpers
+      end
+    end
+  end
+end

data/lib/csedl_stimulus_dropdown/view_helpers.rb

@@ -0,0 +1,138 @@
+module CsedlStimulusDropdown
+  module ViewHelpers
+    #== dropdown helper
+    # @param [button_content] Proc or String for content of the button element
+    # @param [panel_at_place] true (default: false) => it would render the panel into content_for(:dropdown_panels) on sticky parts (left-menu / top-bar) panels should be at place for avoiding that the panel would scroll with the content
+    # @block [panel_content] Panel Content as block
+    # what it does:
+    # * a) wraps the button_content in element like: %button{ data: { controller: 'dropdown', ... } } and renders it at place
+    # * b) wraps the panel_content in a corresponding element and renders it to the dropdown_panels-box (because of z-index-hierarchy)
+    # * c) the stimulus controller always adds the class .dropdown-panel to the panel
+    def dropdown(button_content, title = nil, options = {}, &panel_content)
+      if title.is_a?(Hash)
+        options = title.dup
+        title = nil
+      end
+
+      panel_at_place = options.delete(:panel_at_place)
+
+      id = "dropdown-panel-#{SecureRandom.hex(4)}"
+
+      src = options.delete(:src)
+
+      # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      # create the Button
+      # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+      button_options = options.dup
+      button_options[:class] = [options[:class], 'dropdown-button'].compact.join(' ')
+      button_options = button_options.merge(data: { controller: 'csedl-dropdown', toggle: id })
+
+      button_content = capture(&button_content) if button_content.is_a?(Proc)
+      btn = content_tag(:div, button_content, button_options)
+
+      # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      # create the panel
+      # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+      panel_options = options.dup
+      panel_options[:class] = [options[:class], 'dropdown-panel hide'].compact.join(' ')
+      panel_options[:id] = id
+      panel_options['data-src'] = src if src
+      close_btn_proc = StimulusDropdown.close_button_proc
+
+      panel = content_tag(:div, panel_options) do
+        safe_join([
+                    content_tag(:div, class: 'header') do
+                      concat content_tag(:div, title, class: 'title')
+                      concat content_tag(:div, class: 'buttons') { close_btn_proc.present? ? close_btn_proc.call(self) : 'X' }
+                    end,
+                    content_tag(:div, class: 'content') do
+                      capture(&panel_content) if block_given?
+                    end
+                  ])
+      end
+
+      if panel_at_place
+        btn + panel
+      else
+        content_for(:dropdown_panels, panel)
+        btn
+      end
+    end
+
+
+    def tooltip(label, options = {}, &content)
+
+      panel_at_place = options.delete(:panel_at_place) || false
+      delay = options.delete(:delay) || 0.4
+      src = options.delete(:src)
+      label_class = options.delete(:label_class) || 'tooltip-label'
+
+      id = ['tooltip', SecureRandom.hex(4)].join('-')
+
+      lab = if label.is_a?(Proc)
+              capture &label
+            else
+              label
+            end
+      cont = capture(&content) if block_given?
+
+      # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      # create the Label
+      # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+      label_options = options.dup
+      label_options[:id] = options.delete(:id)
+      label_options[:class] = [options[:class], label_class].compact.join(' ')
+      label_options = label_options.merge(data: { controller: 'csedl-tooltip', toggle: id, delay: delay })
+
+      label_element = if block_given? && cont.present?
+                        content_tag(:span, label_options) do
+                          lab
+                        end
+                      else
+                        lab
+                      end
+
+      # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      # create the panel
+      # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+      panel_options = options.dup
+      panel_options[:class] = [options[:class], 'tooltip-panel hide'].compact.join(' ')
+      panel_options[:id] = id
+      panel_options['data-src'] = src if src
+
+      panel_element = if block_given? && cont.present?
+                        content_tag(:div, panel_options) do
+                          r2 = content_tag :div, id: "arrow-#{id}" do
+                            ; nil;
+                          end
+                          r2 << content_tag(:div, class: 'tooltip-content') do
+                            cont
+                          end
+                        end
+                      end
+
+      # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+      # return the result
+      # xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+
+      if !panel_element
+        label_element
+      elsif panel_at_place
+        r = label_element
+        r << panel_element
+      else
+        content_for(:dropdown_panels) do
+          panel_element
+        end
+        label_element
+      end
+
+    end
+
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: csedl-stimulus-dropdown
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.3
 platform: ruby
 authors:
 - Christian Sedlmair
@@ -15,7 +15,11 @@ email: christian@sedlmair.ch
 executables: []
 extensions: []
 extra_rdoc_files: []
-files: []
+files:
+- README.md
+- lib/csedl-stimulus-dropdown.rb
+- lib/csedl_stimulus_dropdown/railtie.rb
+- lib/csedl_stimulus_dropdown/view_helpers.rb
 homepage: https://gitlab.com/sedl/csedl-stimulus-dropdown
 licenses:
 - MIT