jsf - PrimeFaces 数据表 - 什么是 f :facet actually doing?

Question

查看应用程序中的一些 PrimeFaces 代码，我注意到以下行:

<f:facet name="header">#{trainSearch.trainCount} Trains</f:facet>

看起来它覆盖了 header ，这是有道理的，但是有人可以更详细地向我解释一下吗？

这行代码实际上发生了什么？

完整代码如下:

           <p:dataTable id = "results" value = "#{trainSearch.trains}" var = "train"     rendered="#{not empty trainSearch.trains}" styleClass = "train-search-table horizontal-border">
                <f:facet name="header">#{trainSearch.trainCount} Trains</f:facet> 
                <p:column headerText = "Train ID">
                    <p:panelGrid columns="1" styleClass = "train-id-grid" layout = "grid">
                        <h:outputText styleClass = "train-id-label" value="#{train.trainI}"/>
                        <h:outputText value="#{train.originCityState} > #{train.destinationCityState}" />
                    </p:panelGrid>
                </p:column>
                <p:column headerText="Scheduled Departure">
                    <h:outputText value="#{train.formattedScheduledDepartureText}" />
                </p:column>
                <p:column headerText="Scheduled Arrival">
                    <h:outputText value="#{train.formattedScheduledArrivalText}" />
                </p:column>
                 <p:column headerText="Loco Count">
                    <h:outputText value="#{train.locoCount}" />
                </p:column>
                <p:column headerText="Car Count">
                    <h:outputText value="#{train.carCount}" />
                </p:column>
            </p:dataTable>

Answer 1

JSF 中的分面用于自定义组件的呈现，而无需触及其代码，例如数据表中的 header 分面，您可以在数据表 header 中放置自定义代码，而无需触及实际的 PrimeFaces 数据表代码。

DataTableRenderer(编写数据表 html 代码的类)获取您放入 facet 中的 xhtml 代码并将其呈现在 div 中。

您可以在 DataTableRenderer 的方法 encodeFacet 中看到这一点:

protected void encodeFacet(FacesContext context, DataTable table, UIComponent facet, String styleClass) throws IOException {
    if(facet == null)
        return;

    ResponseWriter writer = context.getResponseWriter();

    writer.startElement("div", null);
    writer.writeAttribute("class", styleClass, null);

    facet.encodeAll(context);

    writer.endElement("div");
}

facet.encodeAll(context); 行在 RENDER_RESPONSE jsf 阶段将您放入 facet 中的代码呈现为 html。