Merge branch 'release/0.2.0'

.github/workflows/ci.yml

@@ -9,7 +9,7 @@ jobs:
   ci:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
 
       - uses: erlef/setup-beam@v1
         with:

README.md

@@ -1,13 +1,14 @@
 # Tabler Icons
 
 [![CI](https://github.com/sourceboat/ex_tabler_icons/actions/workflows/ci.yml/badge.svg)](https://github.com/sourceboat/ex_tabler_icons/actions/workflows/ci.yml)
-[![Hex.pm](https://img.shields.io/hexpm/v/tabler_icons.svg)](https://hex.pm/packages/tabler_icons)
+[![Hex](https://img.shields.io/hexpm/v/tabler_icons.svg)](https://hex.pm/packages/tabler_icons)
+[![Hex Docs](https://img.shields.io/badge/hex-docs-green)](https://hexdocs.pm/tabler_icons/TablerIcons.html)
 
 [Tabler Icons](https://tabler-icons.io/) are free and open source icons. This package provides Elixir functions in order to use [Tabler Icons](https://tabler-icons.io/) in your HTML, styled with arbitrary classes.
 
 This package is strongly inspired by [heroicons_elixir](https://github.com/mveytsman/heroicons_elixir).
 
-> Note: As we are dealing with over 3.000 icons and an output file with more than 100.000 lines of code, the compile time may be longer than usual.
+> Note: As we are dealing with over 3.000 icons and an output file with more than 70.000 lines of code, the compile time may be longer than usual.
 
 ## Installation
 
@@ -25,12 +26,14 @@ end
 
 ```eex
 <TablerIcons.user />
+<TablerIcons.icon name={:user} />
 ```
 
 You may pass arbitrary HTML attributes to the components:
 
 ```eex
 <TablerIcons.user class="w-2 h-2" />
+<TablerIcons.icon name={:user} class="w-2 h-2" />
 ```
 
 For additional information and list of all icons see [the docs](https://hexdocs.pm/tabler_icons/TablerIcons.html).

assets/tabler_icons.exs

@@ -17,6 +17,32 @@ defmodule TablerIcons do
   """
   use Phoenix.Component
 
+  @default_html_attrs %{
+    width: "24",
+    height: "24",
+    viewBox: "0 0 24 24",
+    "stroke-width": "2",
+    stroke: "currentColor",
+    fill: "none",
+    "stroke-linecap": "round",
+    "stroke-linejoin": "round"
+  }
+
+  @doc """
+  Renders an icon dynamically.
+
+  ## Examples
+
+      <TablerIcons.icon name={:user} />
+      <TablerIcons.icon name={:user} class="w-4 h-4" />
+  """
+
+  attr :rest, :global, doc: "arbitrary HTML attributes for the svg container", default: @default_html_attrs
+  attr :name, :atom, required: true, doc: "the name of the icon to be rendered"
+
+  def icon(assigns) do
+    apply(TablerIcons, assigns.name, [assigns])
+  end
 
   <%= for {func, paths} <- @icons do %>
   @doc """
@@ -29,16 +55,7 @@ defmodule TablerIcons do
       <TablerIcons.<%= func %> />
       <TablerIcons.<%= func %> class="w-4 h-4" />
   """
-  attr :rest, :global, doc: "arbitrary HTML attributes for the svg container", default: %{
-    "width": "24",
-    "height": "24",
-    "viewBox": "0 0 24 24",
-    "stroke-width": "2",
-    "stroke": "currentColor",
-    "fill": "none",
-    "stroke-linecap": "round",
-    "stroke-linejoin": "round"
-  }
+  attr :rest, :global, doc: "arbitrary HTML attributes for the svg container", default: @default_html_attrs
 
   def <%= func %>(assigns) do
     ~H"""