Skip to main content

Software Development

Facelets – JavaScript Parsing

FR 2052a

One of the most common issues when starting a project for the 1st time with FACELETS (XHTML + XML) is that it does not handle very well JAVASCRIPT enclosed in a normal <SCRIPT> tag within the JSF file.

The reason behind this is that XML has five special characters which have a special treatment by the XML parser:

• < the start of a tag.

• > the end of a tag.

• “ the start and end of an attribute value.

• ‘ the alternative start and end of an attribute value.

• & the start of an entity (which ends with ;).

For example the following block of code would result in an exception thrown by the XML parser:
Blog Article

Exception thrown:

Blog Article

In order to fix that problem you would need to escape all the XML special characters which would result in the following code:

Blog Article

As you may see now, these makes the JavaScript code harder to read and even harder to maintain, however there are two approaches to deal with this without the need of escaping special characters:

1. CDATA Block.

You can place your JAVASCRIPT in a character data block (CDATA). Basically what this does is parsing your JAVASCRIPT code as simple vanilla character data instead of XML characters.

Your code would look like this:

Blog Article

2. Put your JavaScript in its own file.

Another option, and a much better one if you ask me, is to put the JavaScript code on its own external file and only include the file in your JSF.

Blog Article

By doing this, you will avoid the need of escaping XML characters or putting a CDATA reference in your JAVASCRIPT code, also it is a pretty good practice since you should not clutter your JSF with JavaScript code.


• Predefined entities in XML:

• Writing JavaScript for XHTML

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Luis Millán

More from this Author

Follow Us