I need to customize the ui:include renderer in a way that when it generates the HTML output also adds a comment stating the starting and the ending of the included file.
Example, supposing a blank file.xhtml:
Input
<ui:include src="file.xhtml" />
Output
<!-- START file.xhtml -->
<!-- END file.xhtml -->
At the moment I'm using JSF2.2 with MyFaces, any idea on how I could do that?
On
ui:include is not a UiComponent, and doesn't have a renderer. It is a Facelet TagHandler, and therefore executed when the view is built (or restored). You would have to modify that TagHandler to include additional ELInstruction instances with the desired comments into the component tree.
I don't think JSF offers any nice extension point to override a tag handler of an existing tag library. You could define a new tag in a tag library of your own. You could try to replace the existing tag library definition, though I am not sure this is possible for built-in libraries. Or you could shadow the class definition of the original tag handler in the classpath by providing your own definition for that class (which you would obtain by copying and modifying the original source code). All of these approaches require the duplication of framework code, and will therefore be brittle in maintenance.
On
Customization is also possible via the TagDecorator element, but it's some effort to achieve your goal.
But be careful: The solution only works, if there is no <ui:param> inside the <ui:include>.
The following four TODOs are necessary:
<namespace>http://my-namespace.com/tags/my-tags</namespace>
<tag>
<tag-name>includeWithComment</tag-name>
<source>my/package/includeWithComment.xhtml</source>
<attribute>
<name>src</name>
</attribute>
</tag>
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:ui="http://java.sun.com/jsf/facelets">
<ui:composition>
<!-- START ${src} -->
<ui:include src="${src}" />
<!-- END ${src} -->
</ui:composition>
</html>
<context-param>
<param-name>javax.faces.FACELETS_DECORATORS</param-name>
<param-value>my.package.CommentTagDecorator</param-value>
</context-param>
package my.package;
public class CommentTagDecorator implements TagDecorator {
@Override
public Tag decorate(Tag tag) {
if (!tag.getNamespace().equals("http://xmlns.jcp.org/jsf/facelets")
|| !tag.getLocalName().equals("include")
) {
return null;
}
return new Tag(tag.getLocation(), "http://my-namespace.com/tags/my-tags",
"includeWithComment", "t:includeWithComment", tag.getAttributes());
}
}
Finally your output will look like
<!-- START /include/popup.xhtml -->
[...]
<!-- END /include/popup.xhtml -->
I would suggest to define following facelet tag :
and to use this tag instead ui:include in the code :