JideBuilder is a Groovy builder for the open source JIDE Common Layer

Contribution Overview

JideBuilder will let you create Jide components and standard Swing components as SwingBuilder does, because it doesn't override the default names of previously registered components in SwingBuilder, this means that you can mix both types of components with the same builder.

def jide = new JideBuilder()
   def frame = jide.frame( id: 'frame', title: 'JideBuilder' ){
      panel( layout: new BorderLayout(5,5) ){
      button( label: "Swing", constraints: BorderLayout.WEST )
      jideButton( label: "Jide", constraints: BorderLayout.EAST )
      textField( constraints: BorderLayout.NORTH )
      calculator( constraints: BorderLayout.CENTER )
   }
}

There are 5 *Searchable components that will add searching capabilities to a previously created widget or an internal one, exposing the searchable widget and the searchable wrapper if an 'id' attribute was provided, for example ComboBoxSearchable:

def jide = new JideBuilder()
   def frame = jide.frame( id: 'frame', title: 'JideBuilder' ){
      panel( layout: new BorderLayout(5,5) ){
      comboBox( id: "mycombo", items: [1,2,3] )
      comboBoxSearchable( id: "c1", comboBox: mycombo )
      comboBoxSearchable( id: "c2", items: [4,5,6] )
   }
}
assertNotNull jide.ci_searchable

JIDE Common Layer defines a basic structure for dialogs with StandardDialog, which is an abstract class, you may create your own dialogs based on that template by calling 'standardDialog()', by default all 3 panels will be empty, but yout can provide your own content by calling 'dialogBannerPanel()', 'dialogContentPanel()' and 'dialogButtonPanel()' inside its closure.

All JTextComponents (even those created with regular SwingBuilder methods) will accept a 'selectAll' property, which will call com.jidesoft.swing.SelectAllUtils.install() on the component.
SearchableBar has an additional property 'install' which will register a SearchableBar.Installer automatically into the inmediate container. This property must be a Map and may have the following properties:

• constraints: must be a valid Object accepted by the container's layout (required).
• keyStroke: must be a javax.swing.KeyStroke, defaults to CTRL + F (optional).

Team Members

Andres Almiray [aalmiray at users dot sourceforge dot net]

Download

jidebuilder-1.0
svg-salamander-1.0

Installing

Drop jidebuilder-1.0 into $GROOVY_HOME/lib along with is dependencies

• jide-oss-2.2.1
• svg-salamander-1.0

Pre-requisites

Groovy 1.5 is required to use JideBuilder.

Documentation

Alphabetical list of components

Developers

Andres Almiray

Source Control

http://svn.codehaus.org/groovy-contrib/jidebuilder

Building

JideBuilder uses Maven2 as its build tool, which means that if you want to
build your own version of JideBuilder from source you'll need to have it
installed.  Follow the instructions at http://maven.apache.org
Once Maven2 is installed you will also need to install two other dependencies

• jide-oss-2.2.1
• svg-salamander-1.0

Install them on your local Maven2 repo if needed with the following command

 mvn install:installFile -DgroupId=<group> -Dversion=<version> -Dpackaging=jar \
     -DartifactId=<depname> -Dfile=<jarfile>

substituting the text inside < > with the correct package, version, name and jar file.

Contributing

Please contact the team members by e-mail.

Community

Mailing List(s)

http://groovy.codehaus.org/Mailing+Lists

Issue tracker

http://jira.codehaus.org/secure/BrowseProject.jspa?id=10242