Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

How to create a composite of existing components in JSF?

I'd like to know if it's possible to compose my own component (or call it Widget, Object).

I mean, instead of (for example) using h:panelGroup and a h:outputLabel inside it, make my own h:panelMarkzzz, as a composition of panelGroup and outputLabel.

Is it possible on JSF?

like image 604
markzzz Avatar asked Mar 07 '11 12:03

markzzz


2 Answers

Yes, it's possible to create a composition of existing components like that.

Kickoff example:

/resources/foo/group.xhtml

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml"
    xmlns:h="http://xmlns.jcp.org/jsf/html"
    xmlns:cc="http://xmlns.jcp.org/jsf/composite">
    <cc:interface>
        <cc:attribute name="label" type="java.lang.String" required="true" />
    </cc:interface>
    <cc:implementation>
         <h:panelGroup>
             <h:outputLabel value="#{cc.attrs.label}" />
             <cc:insertChildren />
         </h:panelGroup>
    </cc:implementation>
</html>

/test.xhtml

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" 
    xmlns:h="http://xmlns.jcp.org/jsf/html" 
    xmlns:foo="http://xmlns.jcp.org/jsf/composite/foo">
    <h:head>
        <title>Test</title>
    </h:head>
    <h:body>
        <foo:group label="Label value">
            <h:outputText value="This will appear after label inside the panelgroup" />
        </foo:group>
    </h:body>
</html>

The /foo folder name is free to your taste and you can reference it in XML namespace as http://xmlns.jcp.org/jsf/composite/XXX. The XHTML filename is the tag name.

That said, composite components have performance implications and they should only be used when the functional requirement is not achievable using a simple include or tagfile. In your specific case, you'd better use a tagfile instead. A composite component is only worthy when you actually need it for the <cc:interface componentType="...">.

See also:

  • When to use <ui:include>, tag files, composite components and/or custom components?
  • Our composite component wiki page
  • JSF http://xmlns.jcp.org/jsf/composite tag documentation
  • Java EE 7 tutorial - Composite components
  • Java EE 7 tutorial - Advanced composite components
like image 86
BalusC Avatar answered Sep 30 '22 07:09

BalusC


Perhaps you mean Composite Components?

like image 39
Konrad Garus Avatar answered Sep 30 '22 08:09

Konrad Garus