Xain - Easy HTML in Elixir

Library Providing HTML tag macros for Elixir

Example usage

defmodule Example do
  use Xain

  markup do
    div ("#my-id.my-class") do
      span ".bold Testing"
    end
  end
end

Will render the following:

<div id=&#39;my-id&#39; class=&#39;my-class&#39;><span class=&#39;bold&#39;>Testing</span></div>

HTML Tag Attributes

Additional tag attributes can be included in the html tag by passing in key-value pairs.

markup do
  script src: "http://www.someexamplesite.com/example.js", type: "text/javascript"
end

Will render:

<script src=&#39;http://www.someexamplesite.com/example.js&#39; type=&#39;text/javascript&#39;></script>

Or, with content:

markup do
  a "ExampleSite", [name: "example", href: "http://www.someexamplesite.com/"]
end

Will Render:

<a name=&#39;example&#39; href=&#39;http://www.someexamplesite.com/&#39;>ExampleSite</a>

Configuration

Add a call back to transform the returned html

i.e. Phoenix raw

Add the following to your project’s config file

config :xain, :after_callback, {Phoenix.HTML, :raw}

Will render the above as:

{safe, "<div id='my-id' class='my-class'><span class='bold'>Testing</span></div>"}

Change attribute quoting

To have return markup attributes use single quotes instead of the default double, add the following to your project’s config file.

config :xain, :quote, "\""

Will render the above as:

<div id="my-id" class="my-class"><span class="bold">Testing</span></div>

Acknowledgments

This work was inspired by Chris McCord’s book “Metaprogramming Elixir”, and by the ruby project “Arbre”

License

xain is Copyright (c) 2015-2016 E-MetroTel