dommy.template

dommy.template is a fork of Prismatic's dommy with DOM templating functionality only.

Dommy version 0.1.3 was not compatible with ClojureScript version 0.0-2341 and above. In order to make it compatible with ClojureScript compiler, all templating features of dommy contained in version 0.1.3 were dropped from version 1.0.0. (See this pull request for more details.)

This fork is also based on dommy 0.1.3 and is kind of complement of dommy 1.0.0: it is compatible with ClojureScript version 0.0-2341 and above but all other features except templating have been dropped. The main goal of this fork is to act as a drop-in replacement for templating features of dommy 0.1.3, providing templating macros node and deftemplate.

Usage

Add the following dependency to your project.clj:

[immoh/dommy.template "0.2.0"]

Migration from dommy 0.1.3

Macros node and deftemplate have been moved from namespace dommy.macros to dommy.template. Update your imports accordingly.

Templating (adapted from original documentation)

Templating syntax is based on Hiccup, a great HTML library for Clojure. Instead of returning a string of html, dommy's node macro returns a DOM node.

(ns …
  (:require [dommy.template :as t]))

(t/node
  [:div#id.class1
    (for [r (range 2)]
      [:span.text (str "word" r)])]) ;; => [object HTMLElement]

;; Styles can be inlined as a map
(t/node
  [:span
    {:style
      {:color "#aaa"
       :text-decoration "line-through"}}])

The deftemplate macro is useful syntactic sugar for defining a function that returns a DOM node.

(ns …
  (:require [dommy.template :as t]))

(defn simple-template [cat]
  (t/node [:img {:src cat}]))

(t/deftemplate simple-template [cat]
  [:img {:src cat}])

Type-Hinting Template Macros

One caveat of using the compile-macro is that if you have a compound element (a vector element) and want to have a non-literal map as the attributes (the second element of the vector), then you need to use ^:attrs meta-data so the compiler knows to process this symbol as a map of attributes in the runtime system. Here's an example:

(t/node [:a ^:attrs (merge m1 m2)])

License

Copyright (C) 2013-2014 Prismatic, 2015 Immo Heikkinen

Distributed under the Eclipse Public License, the same as Clojure.