JEditorPane : Java Glossary

* 0-9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z (all)

JEditorPane

JEditorPane is a component in Swing that can be used to render HTML (Hypertext Markup Language) or RTF (Rich Text Format). JEditorPane can use HTMLEditorKit as its plug-in EditorKit. HTMLEditorKit is not a GUI (Graphic User Interface) component in its own right. JEditorPane allows display of formatted HTML or RTF with colours and fonts whereas JTextPane is like JEditorPane but with the additional ability to edit styles and character attributes.

Without any coding, with AWT, the user can select, copy and paste, even in an unsigned Applet. However, Applets must be signed for copy/paste to work in Swing. Copy/paste works in Swing without signing for applications.

JEditorPane needs perfect, validated, simple HTML. Don’t try to feed it wild HTML you screenscrape from websites on the net, e.g. HTML with unbalanced tags, broken links… The JVM (Java Virtual Machine) will just hang. Only use it for rendering HTML you have generated yourself, ideally programmatically so you can be sure it contains no errors.

JEditorPane is simpler than the documentation suggests. You don’t need to get involved with Document structure. You can simply feed it raw HTML text. If you don’t embed the JEditorPane in a JScrollPane, the screen will twitch, a bug in Swing. You would think JEditorPane would be a subclass of JTextPane, but it is the reverse. In the constructor, or it setContentType pass it text/plain.

HTML

If you want to embed HTML formatting, (e.g. <u>…</u> to underline) do a setContentType( text/html ) and a setText with your text sandwiched in <html><body>…</body></html>.

JEditorPane.getText() will give you the HTML text indented and tidied with the DOCTYPE stripped off.

Gotchas

The constructor new JEditorPane( String ) wants an URL (Uniform Resource Locator), not the text. To give it the text use new JEditorPane (text/css, text )
You won’t see any hyperlink events unless you do a setEditable( false );
JEditorPane.setBackground has no effect. You must set colours in HTML markup.
Apple and Linux only support up to HTML 3.2. This means HTML 4 constructs like ’ will not work.
In an Applet your init method will be called multiple times. For some reason setText will usually fail with a NullPointerException on all but the first call.
\r or \n do not cause a break and it is almost impossible to get them to. Use HTML <br>.

RobustJEditorPane

Any errors in the HTML rendered will trigger exceptions. RobustJEditorPane will trap the

Learning More

Oracle’s Javadoc on JEditorPane class : available:

on the web at Oracle.com
in the current JDK 1.8.0_131 on your local Windows J: drive.

HTML rendering
JTextArea
JTextPane
Multi-line labels
Swing
ToolTip

standard footer
	This page is posted on the web at:	http://mindprod.com/jgloss/jeditorpane.html
	Optional Replicator mirror of mindprod.com on local hard disk J:	J:\mindprod\jgloss\jeditorpane.html
	Please read the feedback from other visitors, or send your own feedback about the site. Contact Roedy. Please feel free to link to this page without explicit permission.
	Canadian Mind Products IP:[65.110.21.43] Your face IP:[3.142.174.8]
Feedback	You are visitor number