PrimeFaces DataTable列切换器异常：行错位与可见性重置问题

我之前也踩过PrimeFaces列切换器的类似坑，结合你的问题场景，给你针对性的修复方案：

一、解决数据行偏移/错位问题 #

列切换后出现数据行偏移，空单元格场景下更严重，本质是表格DOM结构和渲染逻辑没有同步更新。你当前的<p:ajax event="toggle" update="datalist"/>只是简单刷新了表格，但PrimeFaces DataTable需要强制触发重绘逻辑才能修正布局。

修改列切换器的ajax配置，添加oncomplete事件调用组件的widget重绘方法：

<p:columnToggler datasource="datalist" trigger="toggler">
    <p:ajax event="toggle" update="datalist" oncomplete="PF('datalistWidget').redraw();" />
</p:columnToggler>

注意：必须给你的DataTable组件加上widgetVar="datalistWidget"属性，这样才能通过PF()方法调用到组件实例。如果redraw()效果不佳，也可以尝试替换为resize()方法重新计算列宽：

PF('datalistWidget').resize();

二、解决动态列visible属性与列切换器冲突的问题 #

你在<p:columns>里硬编码的visible="#{column.property.matches('Z06|Z07|Z09')}"是冲突根源——每次表格更新时，PrimeFaces都会重新执行这个表达式重置列的可见性，直接覆盖列切换器的选择状态。需要把可见性状态绑定到后端Bean的属性上：

1. 后端Bean改造 #

给你的column对象新增boolean类型的visible属性，初始值沿用你原来的匹配逻辑：

// 假设你的自定义Column类结构如下
public class Column {
    private String property;
    private boolean visible;

    // 构造方法初始化可见性
    public Column(String property) {
        this.property = property;
        this.visible = property.matches("Z06|Z07|Z09"); // 初始可见性和原逻辑一致
    }

    // 必须提供getter/setter方法
    public String getProperty() { return property; }
    public void setProperty(String property) { this.property = property; }
    public boolean isVisible() { return visible; }
    public void setVisible(boolean visible) { this.visible = visible; }
}

2. 页面代码调整 #

把<p:columns>的visible属性改为绑定Bean的column.visible，同时给ajax事件添加监听器同步切换状态：

<p:columns value="#{consultationView.columns}" var="column" columnIndexVar="colIndex" 
           visible="#{column.visible}">
    <!-- 你的列内容定义 -->
</p:columns>

<p:columnToggler datasource="datalist" trigger="toggler">
    <p:ajax event="toggle" update="datalist" listener="#{consultationView.onColumnToggle}" 
            oncomplete="PF('datalistWidget').redraw();" />
</p:columnToggler>

3. 添加切换事件监听器 #

在consultationView Bean中实现onColumnToggle方法，同步列切换状态到自定义Column对象：

import org.primefaces.event.ColumnToggleEvent;

public void onColumnToggle(ColumnToggleEvent event) {
    // 获取PrimeFaces内置的列对象
    org.primefaces.model.Column pfColumn = event.getColumn();
    // 匹配到你自定义的Column对象（这里假设用property和headerText关联，需根据实际逻辑调整）
    for (Column customColumn : columns) {
        if (customColumn.getProperty().equals(pfColumn.getHeaderText())) {
            customColumn.setVisible(event.isVisible());
            break;
        }
    }
}

这样修改后，列切换器的选择状态会被持久化到Bean属性中，不会再被硬编码表达式重置，同时也能彻底解决数据行偏移的问题。

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