RSyntaxTextArea

January 15, 2020 · View on GitHub

Remark

This is a patched version of RSyntaxArea fur use in lwb-gui.

The changes are marked by the tag "== Hack esb-dev ==".

Changes

  1. A new folder utils in org.fife.ui with two classes: RecentFilesMenu (from https://github.com/bobbylight/FifeCommon) and SmartScroller by Rob Camick, see https://tips4java.wordpress.com/2013/03/03/smart-scrolling/. I've put the classes into this library for convenience.

  2. Disabled VK_SLASH in RSyntaxTextAreaDefaultInputMap.java. VK_SLASH depends oo the keyboard layout. On a german keyboard SLASH is at the position of MINUS and MINUS is at the position of ß on an american keyboard

  3. A a new function reInit in TextEditorPane.java that allows to use a given TextEditorPane with a new, not yet saved file.

  4. Disabled the folding menu in editor in RSyntaxTextArea.java.

  5. Set version to "3.0.9-esb-dev" and created script localrepo to put the lib into the ,local maven repo.

How to build

  1. Gradle Tasks build jar

  2. localrepo

Build Status Coverage Status

RSyntaxTextArea is a customizable, syntax highlighting text component for Java Swing applications. Out of the box, it supports syntax highlighting for 40+ programming languages, code folding, search and replace, and has add-on libraries for code completion and spell checking. Syntax highlighting for additional languages can be added via tools such as JFlex.

RSyntaxTextArea is available under a BSD 3-Clause license. For more information, visit http://bobbylight.github.io/RSyntaxTextArea/.

Available in the Maven Central repository (com.fifesoft:rsyntaxtextarea:XXX). SNAPSHOT builds of the in-development, unreleased version are hosted on Sonatype.

Building

RSyntaxTextArea uses Gradle to build. To compile, run all unit tests, and create the jar, run:

./gradlew build --warning-mode all

RSTA 3.0 and newer requires Java 8 to compile and run. If you need Java 6 compatibility, you'll need to use a 2.6.x version.

Example Usage

RSyntaxTextArea is simply a subclass of JTextComponent, so it can be dropped into any Swing application with ease.

import javax.swing.*;
import java.awt.BorderLayout;
import org.fife.ui.rtextarea.*;
import org.fife.ui.rsyntaxtextarea.*;

public class TextEditorDemo extends JFrame {

   public TextEditorDemo() {

      JPanel cp = new JPanel(new BorderLayout());

      RSyntaxTextArea textArea = new RSyntaxTextArea(20, 60);
      textArea.setSyntaxEditingStyle(SyntaxConstants.SYNTAX_STYLE_JAVA);
      textArea.setCodeFoldingEnabled(true);
      RTextScrollPane sp = new RTextScrollPane(textArea);
      cp.add(sp);

      setContentPane(cp);
      setTitle("Text Editor Demo");
      setDefaultCloseOperation(EXIT_ON_CLOSE);
      pack();
      setLocationRelativeTo(null);

   }

   public static void main(String[] args) {
      // Start all Swing applications on the EDT.
      SwingUtilities.invokeLater(() -> {
        new TextEditorDemo().setVisible(true);
      });
   }

}

Sister Projects

RSyntaxTextArea provides syntax highlighting, code folding, and many other features out-of-the-box, but when building a code editor you often want to go further. Below is a list of small add-on libraries that add more complex functionality:

  • AutoComplete - Adds code completion to RSyntaxTextArea (or any other JTextComponent).
  • RSTALanguageSupport - Code completion for RSTA for the following languages: Java, JavaScript, HTML, PHP, JSP, Perl, C, Unix Shell. Built on both RSTA and AutoComplete.
  • SpellChecker - Adds squiggle-underline spell checking to RSyntaxTextArea.
  • RSTAUI - Common dialogs needed by text editing applications: Find, Replace, Go to Line, File Properties.

Getting Help