Write NetBeans modules with nice, slick UI, but avoid dependency on Swing or JavaFX! This wiki page is dedicated to NetBeans efforts to bring Java and HTML closer together and use it as a rendering toolkit inside of NetBeans and other environments capable of rendering HTML. Getting your hands dirty with the code:

$ git clone
$ cd html-java-api
$ mvn clean install -DskipTests
$ mvn test

Read about use-cases in our javadoc. Report bugs at bugzilla.

Develop your own applications with Html4Java API by following the tutorial.



  • Jan 7, 2016 Html4Java repository has been migrated to Git thanks to Emilian Bold
  • Mar 15, 2016 Html4Java version 1.3 libraries have been released and are available on Maven central.
  • Mar 1, 2016: Html4Java version 1.3 libraries are ready for testing! Their staging repository is at (updated on Mar 4) - please give them a try before they are uploaded to Maven central and become part of NetBeans 8.2. Thanks!
  • Nov 9, 2015: NetBeans 8.1 is out and includes Html4Java libraries and support!
  • Sep 2, 2015: Html4Java version 1.2.3 is included in forthcoming NetBeans 8.1 release of our beloved IDE
  • Sep 1, 2015: Html4Java version 1.2.3 released on Maven central. See javadoc to find out what is *new* in this version!
  • Dec 26, 2014: Html4Java version 1.1 released on Maven central. See javadoc
  • Dec 18, 2014: HtmlUIForTemplates approved for integration into the NetBeans Platform.
  • Nov 5, 2014: Starting review of HtmlUIForTemplates which harnesses the work done for Html4Java and NetBeans synergy.
  • Sep 29, 2014: DukeScript project (which builds on Html4Java APIs) has won Duke Choice Award.
  • Sep 10, 2014: Html4Java is now part of NetBeans 8.1
  • Sep 9, 2014: Version 1.0 released! See its Javadoc.
  • Aug 26, 2014: Approved for development
  • Jul 31, 2014: Starting review as Issue 246133 to bring version 0.8.3 into NetBeans platform
  • Mar 30, 2014: Published version 0.8 with essential bugfixes and documentation improvements based on the usability study comments.
  • Mar 16, 2014: Published version 0.7.6 with description of available deployment options
  • Feb 14, 2014: We had an API usability study!
  • Feb 7, 2014: Version 0.7.5 published including overall Javadoc.
  • Jan 13, 2014: Version 0.7 has been released and uploaded to maven central.

Inception Review

Notes from review to include Html4Java in NetBeans 8.1.

  • Done: TCR packaging, why SPI packages are in org.apidesign.html? Rename to org.netbeans.html
  • Done: use hg external binaries for 1.0
  • usecases in NetBeans:
    • Done: show top component - via @OpenHTMLRegistration annotation
    • Done: show (modal) dialog - see sample.
    • Done embed in custom & other UI
  • Done: own cluster? wouldn't be able to use from platform. Rejected.
  • Done: geo & sound. They are in separate modules - good.
  • Done: wizard for component/dialog
  • Done: license
    • OK: asm
    • Fixed: knockout.js
  • OK: ko4j name is OK
  • Done: TCR nbrwsr rename to org.netbeans.api.html4j

Approved for development.

Final Review

  • Done: HTMLDialog without any buttons should show JOptionPane.DEFAULT_OPTION - e.g. OK, cancel.
  • Done: Add sample into Javadoc
  • Done: HTMLComponent.type should be JComponent and Node

Approved for integration.


There is a generic part of the HTML/Java API that is lightweight and can be used in any IDE, application and environment:


There is an experimental (to be replaced by official API like HtmlUIForTemplates) NetBeans specific binding and sample application that is suitable for usage in the NetBeans Platform 8.0.x applications:

Not logged in. Log in, Register

By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2012, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo