Primefaces导出Xlsx文件时如何显示列表头名称

问题原因分析 #

1. rendered="false"导致组件未被初始化：当DataTable设置rendered="false"时，JSF不会在服务器端生成该组件的UI实例，PrimeFaces的Exporter无法读取到表头和数据的元信息，因此无法导出表头。
2. exportHeaderValue属性用法错误：该属性用于自定义导出时的表头文本，并非控制表头是否显示的开关，设置为true属于无效值，Exporter无法识别布尔值作为表头内容。

解决方案步骤 #

1. 替换rendered="false"为前端隐藏样式 #

将DataTable的rendered="false"改为style="display:none"，这样组件在服务器端会被正常初始化，仅在前端页面隐藏，Exporter可正常读取组件信息。

2. 修正列的exportHeaderValue属性 #

• 若导出表头与页面显示的headerText一致，直接删除列上的exportHeaderValue="true"，Exporter会自动使用headerText作为导出表头。
• 若需要自定义导出表头文本，将exportHeaderValue设置为具体文本（例如exportHeaderValue="科目代码"）。

修改后的代码示例 #

导出按钮代码（无需修改） #

<p:commandButton styleClass="ui-button-outlined" ajax="false" value="Export" style="margin-right: 10px">
    <p:dataExporter target="aktiva passiva" exportHeader="true" type="xls" fileName="neraca(#{libsDateTime.timeNowStr()})" />
</p:commandButton>

修改后的DataTable代码 #

<p:dataTable style="display:none" id="passiva" value="#{tabunganTransaksiBean.getNeracaPassiva(tabunganTransaksiBean.tampilan, UserObj.id_kantor)}" var="ledger">
    <p:column headerText="coa">
        <h:outputText value="#{ledger.coa}"/>
    </p:column>
    <p:column headerText="nama">
        <h:outputText value="#{ledger.nama_coa}"/>
    </p:column>
    <p:column headerText="nominal">
        <h:outputText value="#{libsRendering.minusSign(ledger.balance)}">
            <f:convertNumber pattern="#,###,##0.00"/>
        </h:outputText>
    </p:column>
    <p:column headerText="jenis">
        <h:outputText value="#{ledger.jenis}"/>
    </p:column>
</p:dataTable>

额外验证点 #

• 确认target属性中的aktiva和passiva是存在的DataTable ID，无拼写错误。
• 检查PrimeFaces版本兼容性，建议使用10+以上的稳定版本，避免旧版本的Exporter bug。

内容的提问来源于stack exchange，提问作者Dena Achmad