Is it possible to use JSF+Facelets with HTML 4/5?
Asked Answered
M

5

66

Facelets relies on XML namespaces to work with XHTML. How are HTML 4, and as far as I know, HTML 5 do not support namespaces. Also HTML 5 has some new elements that are not available in XHTML. Even HTML 4 and XHTML have some differences regarding elements and attributes they support.

The question is: Is it possible to render HTML 4/5 documents using Facelets? If so, how?

Matabele answered 29/5, 2010 at 16:19 Comment(0)
C
101

Since Facelets is a XML based view technology which eats and emits in essence XML markup, you cannot use it with a HTML4 doctype. The HTML4 doctype describes several elements which cannot be self-closing, like <link>, <meta>, <br> and <hr>. However, with XML you're forced to close them like <link/>, <meta/>, etc. So using a HTML4 doctype is absolutely not an option for Facelets (that is, when you respect the standards and/or fear the w3 validator, it will however work perfectly on the most if not all webbrowsers).

HTML5, on the other hand, allows XML markup. This is specified in chapter 3.2.2 - Elements:

Example:

<link type="text/css" href="style.css"/>

Authors may optionally choose to use this same syntax for void elements in the HTML syntax as well. Some authors also choose to include whitespace before the slash, however this is not necessary. (Using whitespace in that fashion is a convention inherited from the compatibility guidelines in XHTML 1.0, Appendix C.)

I myself use <!DOCTYPE html> all the way, also with JSF/Facelets, even without a <?xml?> declaration in top of the page. It works perfectly in all browsers.

As per your arguments:

HTML 5 do not support namespaces.

This doesn't matter. The namespaces are only of interest for the XML based server side view technology (like as Facelets) which in turn can generate pure HTML with those tags. The following example is legitimately valid for Facelets:

<!DOCTYPE html>
<html lang="en"
    xmlns:f="http://xmlns.jcp.org/jsf/core" 
    xmlns:h="http://xmlns.jcp.org/jsf/html">
    <h:head>
        <title>Title</title>
    </h:head>
    <h:body>
        <h:outputText value="#{bean.text}" />
    </h:body>
</html>

This renders legitimately valid HTML5 (for the client side):

<!DOCTYPE html>
<html lang="en">
    <head>
        <title>Title</title>
    </head>
    <body>
        Some text
    </body>
</html>

You see, Facelets already removes the XHTML declarations since they have no meaning in the client side.

And,

Also HTML 5 has some new elements that are not available in XHTML

this make also no sense. It's all about the generated output. Which can be HTML5 as good. Your only problem may be the browser support and the availability of 3rd party JSF components which renders HTML5 specific elements. Since JSF 2.2, it's possible to use the new passthrough elements feature to turn custom elements into a JSF component. Simply give the HTML5 element a jsf:id attribute. It'll transparently internally be interpreted as a UIPanel instance in the JSF component tree (like <h:panelGroup>).

<!DOCTYPE html>
<html lang="en"
    xmlns:jsf="http://xmlns.jcp.org/jsf"
    xmlns:f="http://xmlns.jcp.org/jsf/core" 
    xmlns:h="http://xmlns.jcp.org/jsf/html"
>
    <h:head>
        <title>Title</title>
    </h:head>
    <h:body>
        <header jsf:id="header">Header</header>
        <nav jsf:id="nav">Nav</nav>
        <main jsf:id="main">Main</main>
        <footer jsf:id="footer">Footer</footer>
    </h:body>
</html>

You can even reference it from ajax as in <f:ajax render="main">.

Actually, XHTML is overhyped. Its sole intent is to ease HTML development using XML based tools which can manipulate/transform/generate HTML pages on the server side (like as Facelets). But some starters also use it without using any XML tool and output it plain as-is, because it's "so cool" -for some unclear reason. Do note that it's even considered harmful to do so.

In a nutshell, XHTML is great as server side view technology, but simply not as client side markup technology. It has utterly no value at the client side.

See also:

Cadmus answered 6/10, 2010 at 2:41 Comment(15)
XHTML is designed to be compatible with HTML4. It isn't?Porcelain
@Thor: XHTML1 is a "reformulation" of HTML4 as a XML 1.0 application. As to compatibility, the w3 validator will only issue warnings (not errors) when you close non-self-closing elements while validating against HTML4. It will work without problems on most if not all browsers.Cadmus
In the past couple of days Stackoverflow was unstable and it seems that my previous comment to your answer has been lost as such. Anyway, thanks for the answer.Matabele
The problem is this won't "work". Using the html5 doctype makes HTML entities like "&copy;" unavailable. javax.faces.view.facelets.FaceletException: Error Parsing /WEB-INF/templates/basic.xhtml: Error Traced[line: 82] The entity "copy" was referenced, but not declared.Rodolforodolph
XHTML has tons of value on the client side. How about extremely easy validation instead of all sorts of strange rules about termination of certain tags?Berlioz
@exabrial: that's more an advantage to the developer, not exactly for the website enduser.Cadmus
I'm very intrigued as converting my xhtml files to html5 would be wonderful, but your example does not work for me. I can't get any JSF components to show up unless on a .xhtml page. I simply replaced the <?xml?> and (insert long a** doctype here) to <!DOCTYPE html> and changed .xhtml to .html, is there something else I need to set up? My faces servlet is configured for /faces/*Churn
@Jake: You shouldn't need to change the file extension. Just the doctype. If you really need to change the file extension as well, set the javax.faces.DEFAULT_SUFFIX context param to .html (it defaults to .xhtml).Cadmus
ah, just got that as you posted it. thanks! could you explain why I need that?Churn
@Jake: It's just the default Facelets template file extension. The Facelets template file extension has totally no influence on the behavior of the doctype and contenttype. You can even use .xyz or something. You'll possibly only need to change the tooling (IDE, etc) to recognize that extension as well so that you can continue using highlighting/autocomplete facilities and so on.Cadmus
@Jake: :) Just keep asking questions here on SO. I love to share the information therein.Cadmus
@Cadmus What about the extension of the file '.xhtml'? Should that be changed to 'html'? Also browser gets MIME type text/html of a '.xhtml' JSF page with <!DOCTYPE html> and no 'xml' initial tag.Pellet
@HendyIrawan Hello, is there any solution to &copy problem you mentioned here?Hunyadi
Roughly 2 years ago, I basically wrote a library that contains JSF UIComponent's and Renderer to strictly follow the HTML5 elements and its attributes. That was before JSF introduced passthrough attributes. I still maintain it to this very day and I can safely say I still use it to this day. :-)Realistic
I have a similar problem: stackoverflow.com/questions/27574351/… Could someone help me, please?Digit
R
9

On a related note, check out this IBM developerWorks article: JSF 2 fu: HTML5 composite components, Part 1

Rosemaryrosemond answered 12/10, 2010 at 18:33 Comment(0)
C
4

MyFaces has an extension for html5. Try this http://myfaces.apache.org/html5/

Critical answered 8/3, 2012 at 7:29 Comment(0)
S
3

I've read, that this should be possible, but I did not do it myself, yet. Maybe you should just use HTML 5 inside the xHTML wrapper code. I will see, if I can find the source of information I've again.

[EDIT] Seems like, there has been some work at MyFaces to support HTML5 rendering during Google's summer of code. I don't know if it should be used in a productive way, yet.

Please give us a feedback, if you get it to work. [/EDIT]

Shafting answered 4/10, 2010 at 17:11 Comment(0)
S
2

http://wiki.whatwg.org/wiki/HTML_vs._XHTML has some useful information on how namespaces can be used in HTML5 to assist migration from XHTML. Perhaps you can try applying the namespace as it suggests and see what occurs?

Snath answered 5/10, 2010 at 16:18 Comment(0)

© 2022 - 2024 — McMap. All rights reserved.