Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Seesaw turns the Horror of Swing into a friendly, well-documented, Clojure library
Clojure HTML Other

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
src/seesaw
test/seesaw/test
.gitignore
README.md
epl-v10.html
project.clj

README.md

Seesaw: Clojure + UI

"killing CamelCase, proxy and reify, one class at a time"

Seesaw's experimental and subject to radical change

See the Seesaw Wiki for more detailed docs

Seesaw is a library/DSL for constructing user interfaces in Clojure. It happens to be built on Swing, but please don't hold that against it. It's an experiment to see what I can do to make user interface development funner in Clojure. It's kinda inspired by Shoes, Stuart Sierra's Swing posts, etc. clojure.contrib.swing-utils is useful, but minimal and still means a lot of "Java-in-Clojure" coding.

TL;DR

Here's how you use Seesaw with Leiningen

Install lein as described and then:

$ lein new hello-seesaw
$ cd hello-seesaw

Add Seesaw to project.clj

(defproject hello-seesaw "1.0.0-SNAPSHOT"
  :description "FIXME: write"
  :dependencies [[org.clojure/clojure "1.2.0"]
                [org.clojure/clojure-contrib "1.2.0"]
                [seesaw "1.0.1"]])

Replace the Seesaw version with whatever the latest version tag is in case I forget to update this. See below!

Now edit the generated src/hello_seesaw/core.clj file:

(ns hello-seesaw.core
  (:use seesaw.core))

(defn -main [& args]
  (invoke-later 
    (frame :title "Hello", 
           :content "Hello, Seesaw",
           :on-close :exit)))

Now run it:

$ lein run -m hello-seesaw.core

NOTE: As mentioned above, Seesaw is experimental and changing daily. Thus, there's a good chance that what's on clojars and what's written here are out of sync. Here's how you can run against the bleeding edge of Seesaw:

  • Clone Seesaw from github. Fork if you like. Switch to the "develop" branch.
  • In your Seesaw checkout, run lein install to build it
  • In your project's project.clj file, change the Seesaw version to X.Y.Z-SNAPSHOT to match whatever's in Seesaw's project.clj.
  • Run lein deps
  • Move along

TODO

  • A non-trivial example app to see if this stuff holds up
  • GridBagLayout needs more work
  • Graphics - I'd rather not wrap the entire Java2D API if there's already something out there (maybe processing?) that does that.
  • Structural manip - add/remove widgets to containers.
  • Selectors - select widgets by class, data, etc.
  • Styling
  • Some kind of ToModel protocol for auto-converting Clojure data-structures to Swing models.
  • Investigate how a framework like cljque might fit in with Seesaw

License

Copyright (C) 2011 Dave Ray

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

Something went wrong with that request. Please try again.