heroicons_helper 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea79c1638e02674896f2f251375b879df8e289d10c39bd1b6550b35f65bb667e
-  data.tar.gz: 49e4f89e38f7ceec4e09970d9864f859424f4e59f314b40353df87e73ff128b9
+  metadata.gz: 2a4fd38721f8363f1f2b36b45cec732c0dba30f7ac3ad5d1cb243a8e5a722bda
+  data.tar.gz: 59333a78638dacbc4690bc22d231382d79addea64d4bb703b2efbdb4ccc052df
 SHA512:
-  metadata.gz: c4c7715c0dc796769dd80fd26e38a56bbccadb1c00418ac0ff8911722679bd571e2a2cb058ecbf3931e9c6da3020628239ee5500ef90b05aed66c53f856bec5c
-  data.tar.gz: 0257f55a823a70b7147b4ac0d7c3051fd407febea7577b0ffd2cc9bb2e14b7582299daae2a425f273de59ca7bd4dd5ddd51181baeb5ac40cdd47c1006224a324
+  metadata.gz: 1aef948793f04e86a224734f44da163f037a26c74f392757c0cb0b7546ae26edbfb00ef6ef0bd5bed5bea6b93be49933f3c432f28c94b9654b2905028dced010
+  data.tar.gz: 40c2239119dc8de51e43e55260e2bd9190faaad885ae1e53f4a5b4a24eb2420f5cc5d0e5fb13658c9a5cae55563d319fd858895a23dedbb5611da192d87bb654

data/README.md

@@ -37,7 +37,7 @@ where
 This one method call returns an object that represents the Heroicon, and you should call `to_svg` to get the resulting SVG string:
 
 ```ruby
-outline_icon = heroicon("x", "outline")
+outline_icon = heroicon("x", variant: HeroiconsHelper::Icon::VARIANT_OUTLINE)
 puts outline_icon.to_svg
 ```
 ```

data/lib/heroicons_helper/icon.rb

@@ -3,22 +3,29 @@
 module HeroiconsHelper
   # Icon to show heroicons by name and variant.
   class Icon
-    attr_reader :path, :attributes, :width, :height, :symbol, :variant
+    attr_reader :path, :attributes, :width, :height, :symbol, :variant, :keywords
 
     VARIANT_OUTLINE = "outline"
     VARIANT_SOLID = "solid"
     VARIANTS = [VARIANT_OUTLINE, VARIANT_SOLID].freeze
 
     def initialize(symbol, variant, attributes: {})
-      @symbol = symbol
-      @variant = variant
-
-      icon = get_heroicon(@symbol, @variant)
-
-      @path = icon["path"]
-      @width = icon["width"]
-      @height = icon["height"]
-      @attributes = attributes.dup.merge!(default_attributes)
+      @symbol = symbol.to_s
+      @variant = variant.to_s
+
+      heroicon = get_heroicon(@symbol, @variant)
+
+      @path = heroicon["path"]
+      @width = heroicon["width"]
+      @height = heroicon["height"]
+      @keywords = heroicon["keywords"]
+      @attributes = attributes.dup
+      @attributes[:class] = classes
+      @attributes[:viewBox] = viewbox
+      @attributes.merge!(size)
+      @attributes[:version] = "1.1"
+      @attributes.merge!(variant_attributes)
+      @attributes.merge!(a11y)
     end
 
     # Returns an string representing a <svg> tag
@@ -26,54 +33,93 @@ module HeroiconsHelper
       "<svg xmlns=\"http://www.w3.org/2000/svg\" #{html_attributes}>#{@path}</svg>"
     end
 
-    private
-
-    def html_attributes
+    private def html_attributes
       attrs = []
       @attributes.each_pair { |attr, value| attrs << "#{attr}=\"#{value}\"" }
       attrs.map(&:strip).join(" ")
     end
 
-    def default_attributes
+    # add some accessibility features to svg
+    private def a11y
+      accessible = {}
+
+      if @attributes[:"aria-label"].nil? && @attributes["aria-label"].nil?
+        accessible[:"aria-hidden"] = "true"
+      else
+        accessible[:role] = "img"
+      end
+
+      accessible
+    end
+
+    # prepare the octicon class
+    private def classes
+      "heroicon heroicon-#{@symbol}-#{@variant} #{@attributes[:class]} ".strip
+    end
+
+    private def variant_attributes
       case @variant
       when VARIANT_OUTLINE
         {
-          viewBox: viewbox,
           fill: "none",
           stroke: "currentColor",
         }
       when VARIANT_SOLID
         {
-          viewBox: viewbox,
           fill: "currentColor",
         }
       end
     end
 
-    def viewbox
+    private def viewbox
       "0 0 #{@width} #{@height}"
     end
 
-    def get_heroicon(symbol, variant)
-      symbol_s = symbol.to_s
-      raise ArgumentError, "Icon name can't be empty" if symbol_s.empty?
+    # determine the height and width of the octicon based on :size option
+    private def size
+      size = {
+        width: @width,
+        height: @height,
+      }
+
+      # Specific size
+      unless @attributes[:width].nil? && @attributes[:height].nil?
+        size[:width]  = @attributes[:width].nil? ? calculate_width(@attributes[:height]) : @attributes[:width]
+        size[:height] = @attributes[:height].nil? ? calculate_height(@attributes[:width]) : @attributes[:height]
+        @width = size[:width]
+        @height = size[:height]
+      end
+
+      size
+    end
+
+    private def calculate_width(height)
+      (height.to_i * @width) / @height
+    end
+
+    private def calculate_height(width)
+      (width.to_i * @height) / @width
+    end
+
+    private def get_heroicon(symbol, variant)
+      raise ArgumentError, "Icon name can't be empty" if symbol.empty?
 
-      variant_s = variant.to_s
-      raise ArgumentError, "Variant `#{variant.inspect}` is invalid; must be one of #{VARIANTS.join(", ")}" unless VARIANTS.include?(variant_s)
+      raise ArgumentError, "Variant `#{variant.inspect}` is invalid; must be one of #{VARIANTS.join(", ")}" unless VARIANTS.include?(variant)
 
-      icon = HeroiconsHelper::ICON_SYMBOLS[symbol_s]
+      icon = HeroiconsHelper::ICON_SYMBOLS[symbol]
 
       raise ArgumentError, "Couldn't find Heroicon for `#{symbol.inspect}`" unless icon
 
-      icon_in_variant = icon["variants"][variant_s]
-      raise ArgumentError, "Heroicon for `#{symbol.inspect}` doesn't have variant `#{variant.inspect}`" unless icon_in_variant
+      icon_variant = icon["variants"][variant]
+      raise ArgumentError, "Heroicon for `#{symbol.inspect}` doesn't have variant `#{variant.inspect}`" unless icon_variant
 
       {
         "name" => icon["name"],
-        "variant" => variant_s,
-        "width" => icon_in_variant["width"],
-        "height" => icon_in_variant["height"],
-        "path" => icon_in_variant["path"],
+        "variant" => variant,
+        "keywords" => icon["keywords"] || [],
+        "width" => icon_variant["width"],
+        "height" => icon_variant["height"],
+        "path" => icon_variant["path"],
       }
     end
   end

data/lib/heroicons_helper/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HeroiconsHelper
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/heroicons_helper.rb

@@ -9,7 +9,7 @@ module HeroiconsHelper
   file_data = File.read(File.join(File.dirname(__FILE__), "./heroicons_helper/data.json"))
   ICON_SYMBOLS = JSON.parse(file_data).freeze
 
-  def heroicon(symbol, variant, attributes: {})
+  def heroicon(symbol, variant:, **attributes)
     ::HeroiconsHelper::Icon.new(symbol, variant, attributes: attributes)
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: heroicons_helper
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Garen J. Torikian
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-06-10 00:00:00.000000000 Z
+date: 2022-06-11 00:00:00.000000000 Z
 dependencies: []
 description: A package that distributes Heroicons as a gem, for easy inclusion in
   Ruby projects.