Tablerone is a library for downloading specific tabler icons to the local application, and then rendering them from the file system.

Installation

Tablerone must be configured to know the parent application, in config/config.exs:

import Config

# ...existing config

config :tablerone, :otp_app, <:my_app>

Usage

When using new icons, they can be downloaded using the provided mix task:

mix tablerone.download <icon-name> <icon-name>

To load an icon in a heex component, the following example code may be used:

attr :name, :atom, required: true
attr :class, :any, default: []

def icon(assigns) do
  name = assigns[:name]
  icon_contents = Tablerone.icon(name)

  assigns =
    assign_new(assigns, :icon_contents, fn ->
      class = [class: assigns[:class]] |> Phoenix.HTML.attributes_escape() |> Phoenix.HTML.safe_to_string()
      String.replace(icon_contents, ~r{class="[^"]+"}, class)
    end)

  ~H"""
  <%= Phoenix.HTML.raw(@icon_contents) %>
  """
end