https://github.com/8thlight/hiccup
Fast library for rendering HTML in Clojure
https://github.com/8thlight/hiccup
Last synced: 8 months ago
JSON representation
Fast library for rendering HTML in Clojure
- Host: GitHub
- URL: https://github.com/8thlight/hiccup
- Owner: 8thlight
- License: epl-1.0
- Fork: true (weavejester/hiccup)
- Created: 2013-12-04T17:23:56.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2014-06-03T23:48:48.000Z (about 12 years ago)
- Last Synced: 2025-09-22T03:59:52.514Z (9 months ago)
- Language: Clojure
- Homepage: http://weavejester.github.com/hiccup
- Size: 582 KB
- Stars: 0
- Watchers: 67
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.html
Awesome Lists containing this project
README
Hiccup
======
[](http://travis-ci.org/weavejester/hiccup)
Hiccup is a library for representing HTML in Clojure. It uses vectors
to represent elements, and maps to represent an element's attributes.
Install
-------
Add the following dependency to your `project.clj` file:
[hiccup "1.0.4"]
Documentation
-------------
* [Wiki](https://github.com/weavejester/hiccup/wiki)
* [API Docs](http://weavejester.github.com/hiccup)
Syntax
------
Here is a basic example of Hiccup syntax:
```clojure
user=> (use 'hiccup.core)
nil
user=> (html [:span {:class "foo"} "bar"])
"bar"
```
The first element of the vector is used as the element name. The second
attribute can optionally be a map, in which case it is used to supply
the element's attributes. Every other element is considered part of the
tag's body.
Hiccup is intelligent enough to render different HTML elements in
different ways, in order to accommodate browser quirks:
```clojure
user=> (html [:script])
""
user=> (html [:p])
"
"
```
And provides a CSS-like shortcut for denoting `id` and `class`
attributes:
```clojure
user=> (html [:div#foo.bar.baz "bang"])
"
"
```
If the body of the element is a seq, its contents will be expanded out
into the element body. This makes working with forms like `map` and
`for` more convenient:
```clojure
user=> (html [:ul
(for [x (range 1 4)]
[:li x])])
"
- 1
- 2
- 3
```