ui:decorate和ui:include之间真正的概念差异是什么?

时间:2012-05-27 23:51:08

标签: jsf facelets

我发现ui:decorate在功能上与ui:include相同,只是您还可以将ui:paramui:define传递给所包含的文件。

我疯了吗?

编辑:虽然实际上您也可以将ui:param传递给ui:include文件,但事实证明我已经在做了。也许你也可以传递ui:define,我会在这里查看和编辑。

1 个答案:

答案 0 :(得分:45)

<ui:include><ui:decorate>之间的主要区别在于<ui:decorate>旨在允许插入用户定义的模板组件,而<ui:include>旨在包含现有的和已经预定义的模板。

这确实意味着<ui:decorate>支持<ui:define>用于其身体中的用户定义模板组件,并且可以将其插入模板内的<ui:insert>位置。

这是一个有点笨拙的例子来展示它的用途:

/WEB-INF/templates/field.xhtml

<ui:composition
    xmlns="http://www.w3.org/1999/xhtml"
    xmlns:f="http://java.sun.com/jsf/core"
    xmlns:h="http://java.sun.com/jsf/html"
    xmlns:ui="http://java.sun.com/jsf/facelets"
>
    <h:outputLabel for="#{id}" value="#{label}" />
    <ui:insert name="input" />
    <h:message id="#{id}_message" for="#{id}" />
</ui:composition>

/page.xhtml

<h:panelGrid columns="3">
    <ui:decorate template="/WEB-INF/templates/field.xhtml">
        <ui:param name="label" value="Foo" />
        <ui:param name="id" value="foo" />
        <ui:define name="input">
            <h:inputText id="foo" value="#{bean.foo}" required="true" />
        </ui:define>
    </ui:decorate>
    <ui:decorate template="/WEB-INF/templates/field.xhtml">
        <ui:param name="label" value="Bar" />
        <ui:param name="id" value="bar" />
        <ui:define name="input">
            <h:selectBooleanCheckbox id="bar" value="#{bean.bar}" required="true" />
        </ui:define>
    </ui:decorate>
    ...
</h:panelGrid>

请注意,它会在面板网格的每个单元格中很好地呈现组件。同样,这个特殊的例子非常笨拙,我只是使用了tag file。只有它是一个更大的部分,例如整个形式,例如它的页眉或页脚应该是可自定义的,那么<ui:decorate>就是合适的。

<ui:decorate>的另一个主要优点是它允许您将复合组件与模板一起使用。另请参阅Is it possible to use template with composite component in JSF 2?