TinyMCE for Swing integration
Users can easily configure the TinyMCE editor in Swing through the TinyMCE for Swing integration.
Getting the TinyMCE for Swing integration
To start using TinyMCE for Swing as your new rich text editor, the first step is to obtain a copy of the Integration.
Contact Tiny Support to discuss how to get started with our latest release.
Get started with our TinyMCE in Swing integration
To include our TinyMCE in Swing integration in your Java project just follow the steps below:
1. Copy TinyMCE in Swing libraries
From the release zip
file, select all the Java libraries under the lib
folder and import them into your project. This libraries contain everything needed to run our integration.
2. Select a deployment and create a configuration
The Swing integration allows the user to select the origin of the TinyMCE code: embedded (recommended), cloud, or external.
-
Embedded deployments use the version of TinyMCE prepackaged with the current release of the integration. This is guaranteed to be compatible with the integration specific plugins.
final Config myTinyConfiguration = Config.embedded();
-
Cloud deployments pull TinyMCE from the Tiny Cloud. Use this option by passing your API key and specifying the Tiny Cloud version.
final Config myTinyConfiguration = Config.cloud("<my_api_key>", "5-stable");
-
External deployments allow to use a local version of TinyMCE by giving the address of the location where TinyMCE is being served.
final Config myTinyConfiguration = Config.external("http://<my_server>/<path>/tinymce.min.js");
The configuration can be customized purely in Java:
final Path contentPath = Paths.get(System.getProperty("user.home"));
final Config myConfig = Config.embedded()
.setContentPath(contentPath)
.setImageSaverLocal(contentPath)
.addPlugins(
"advcode advlist autolink lists link image imagetools charmap emoticons " +
"anchor searchreplace insertdatetime media table powerpaste help wordcount")
.putProperty("width", 800)
.putProperty("height", 600)
.putProperty("menubar", false)
.putProperty("toolbar",
"undo redo | formatselect | bold italic backcolor | " +
"alignleft aligncenter alignright alignjustify | " +
"bullist numlist outdent indent | removeformat | link image | help")
.putProperty("images_reuse_filename", true);
Or by passing Javascript that returns a TinyMCE configuration object.
config.js:
(function() {
return {
width: 800,
height: 600,
plugins: [
'advcode advlist autolink lists link image imagetools charmap emoticons',
'anchor searchreplace insertdatetime media table powerpaste help wordcount'
],
menubar: false,
toolbar: [
'undo redo | formatselect | bold italic backcolor | alignleft aligncenter ',
'alignright alignjustify | bullist numlist outdent indent | removeformat | ',
'link image | help'
].join(''),
images_reuse_filename: true
};
})()
Snippet of Edit.java:
final Path contentPath = Paths.get(System.getProperty("user.home"));
final Config myConfig = Config.embedded()
.setContentPath(contentPath)
.setImageSaverLocal(contentPath)
.setInitConf(Edit.class, "config.js"); // load config.js using class loader
3. Create the editor and add it to your view
Create the editor by passing a configuration object. The editor initialization is asynchronous so starting a new editor will return a future value that can be accessed as a normal future value.
final Config myConfig = Config.embedded();
final TinyMCE editor = TinyMCE.futureEditor(myConfig).get();
editor.setHtml("<p>Hello World!</p>");
final JPanel holder = new JPanel(new BorderLayout());
holder.add(editor.component(), BorderLayout.CENTER);
Once the editor has been extracted from the future value you can use its component (JComponent) to position it in your view.
For more examples check the GitHub repository.
Explore other resources
-
GitHub repository - Refer to this link for examples on how to use TinyMCE for Swing.
-
An additional set of documentation is shipped with the integration in a
zip
file containing a library ofJavadocs
and API reference guides which help in understanding and applying the concepts. Thezip
file includes the following documents:-
readme.txt
- This file has general information about TinyMCE for Swing integration. -
license.txt
- This file has all the license details about TinyMCE for Swing as a commercial software. -
release-notes.txt
- This file has information about the integrations and enhancements that have been implemented in TinyMCE for Swing integration. -
change-log.md
- This file lists all user impacting and major changes for every release of TinyMCE for Swing integration. -
jar
files - Thejar
files that implement the integration can be found underlib/
-
javadoc
- Thejavadoc
can be found atdocs/javadoc/index.html
.
-