clj-commons / seesaw

Seesaw turns the Horror of Swing into a friendly, well-documented, Clojure library
https://groups.google.com/group/seesaw-clj
1.48k stars 149 forks source link

Build Status

There's now a Google Group for discussion and questions.

Here's a brief tutorial that covers some Seesaw basics. It assumes no knowledge of Swing or Java.

Here's the slides from a Clojure/West 2012 talk on the Seesaw. Best viewed in Chrome or Safari.

Seesaw: Clojure + UI

See the Seesaw Wiki and the Seesaw API Docs for more detailed docs. Note that the docs in the code (use the doc function!) are always the most up-to-date and trustworthy.

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.

Features

Seesaw is compatible with Clojure 1.4, but will probably work fine with 1.3 and 1.5. Maybe even 1.2.

There are numerous Seesaw examples in test/seesaw/test/examples.

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.4.0"]
                [seesaw "x.y.z"]])

Replace the Seesaw version with whatever the latest version tag is. 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)
     pack!
     show!)))

Now run it:

$ lein run -m hello-seesaw.core

NOTE: Here's how you can run against the bleeding edge of Seesaw:

Contributors

License

Copyright (C) 2012 Dave Ray

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