README

clj-pivot: a library to comfortably use Apache Pivot (http://pivot.apache.org) from Clojure

Example

(ns pivot.test
  (:require [hoeck.pivot :as pivot]
            [hoeck.pivot.components :as cm]))

(pivot/start #(pivot/show % (cm/boxpane (cm/push-button :data "Hello Pivot"))))


Getting Started

see howto.clj for a small introduction to clj-pivot


Features:
 
 * apache pivot
   - rich set of widgets, see:
       http://pivot.apache.org/demos/kitchen-sink.html
     and
       http://pivot.apache.org/demos/component-explorer.html
   - clean, modern and consistent api
   - dynamic
   - deployable as Desktop Application or Applet

 * use the pivot api from clojure
   - less java calls
   - convenient constructor functions
   - easily to compose custom widgets
   - function level documentation

 * declarative GUI definition using s-expressions

 * traversable component tree

 * data-binding using clojure hashmaps


Limitations

 * limited to one host window
 * closing the that window will quit the clojure-repl too
 * requires the (unreleased) latest clojure (1.2-snapshot)


TODO:

 * integrate drag and drop
 * add more custom components
 * more clojure-backed renderers/editors (for tree-views, listboxes ..)