Clojure Desktop Toolkit Documentation

Start here. 😁

Introduction

The Eclipse SWT (Standard Widget Toolkit) library, on which the Clojure Desktop Toolkit is based, rigorously adheres to a set of standard naming and usage conventions. As a result, it is possible to mechanically generate a Clojure API for SWT using Java reflection and Clojure macros at compile time.

This is what the Clojure Desktop Toolkit does; it also makes SWT and Clojure Desktop Toolkit easier to understand by reducing the surface area of things one must remember in order to work effectively. Everything boils down to a small set of rules and naming conventions.

Contents

Getting started

• Install Java, Clojure, Visual Studio Code, and Calva
• Create a new Clojure Desktop Toolkit application

Tutorial

• Hello, world - The basic API
• Hello, world without syntactic sugar - Learn how (nearly) everything works
• Idiomatic SWT property assignment and type conversions
• Props, custom init functions, and state management
• Event handling
• The user interface thread
• Disposable resources

SWT Basics - A basic tour and quick reference

• SWT documentation at Eclipse.org
  • Widgets
  • Layouts
• The SWT widget hierarchy
• Typical widget methods
• SWT layout managers
• SWT Items
• Graphics and drawing

Reference information

• Try the swtdoc function in the REPL
• The SWT "snippets" collection
• Design principles

Back to README.md