Primefaces DataTable：仅禁用表头全选复选框，保留子项可选

方法一：客户端脚本结合条件控制 #

PrimeFaces的DataTable表头全选复选框有固定DOM结构，可根据行内编辑状态，用JavaScript动态禁用表头复选框：

1. 在页面添加脚本，通过#{bean.disabledSelection}条件控制：

$(document).ready(function() {
    if (#{bean.disabledSelection}) {
        // 定位表头全选复选框容器
        const headerCheckboxBox = $('.ui-datatable-header .ui-chkbox-box');
        if (headerCheckboxBox.length > 0) {
            // 添加禁用样式
            headerCheckboxBox.addClass('ui-state-disabled');
            // 阻止点击事件传播
            headerCheckboxBox.parent().off('click').on('click', function(e) {
                e.preventDefault();
                e.stopPropagation();
            });
            // 禁用底层input元素
            headerCheckboxBox.prev('input[type="checkbox"]').prop('disabled', true);
        }
    }
});

如果DataTable通过AJAX动态更新，需将这段脚本放到p:ajax的oncomplete回调中，确保每次更新后重新执行。

方法二：自定义DataTable渲染器（服务端控制） #

若需要更优雅的服务端控制，可自定义渲染器重写表头复选框渲染逻辑：

1. 创建自定义渲染器，继承PrimeFaces原生渲染器：

public class CustomDataTableRenderer extends DataTableRenderer {
    @Override
    protected void renderHeaderCheckbox(FacesContext context, DataTable table) throws IOException {
        ResponseWriter writer = context.getResponseWriter();
        // 从组件属性获取禁用条件
        boolean disableHeaderSelect = Boolean.TRUE.equals(table.getAttributes().get("disableHeaderSelection"));
        
        writer.startElement("div", null);
        writer.writeAttribute("class", "ui-chkbox ui-widget", null);
        if (disableHeaderSelect) {
            writer.writeAttribute("style", "pointer-events: none; opacity: 0.6;", null);
        }
        
        writer.startElement("div", null);
        writer.writeAttribute("class", "ui-chkbox-box ui-widget ui-corner-all ui-state-default", null);
        
        writer.startElement("input", null);
        writer.writeAttribute("type", "checkbox", null);
        writer.writeAttribute("class", "ui-chkbox-input", null);
        if (disableHeaderSelect) {
            writer.writeAttribute("disabled", "disabled", null);
        }
        writer.endElement("input");
        
        writer.endElement("div");
        writer.endElement("div");
    }
}

2. 在faces-config.xml中注册自定义渲染器：

<render-kit>
    <renderer>
        <component-family>org.primefaces.component</component-family>
        <renderer-type>org.primefaces.component.DataTableRenderer</renderer-type>
        <renderer-class>com.your.package.CustomDataTableRenderer</renderer-class>
    </renderer>
</render-kit>

3. 页面中使用时传入自定义条件属性：

<p:dataTable ...>
    <f:attribute name="disableHeaderSelection" value="#{bean.disabledSelection}" />
    <!-- 列定义 -->
</p:dataTable>

方法三：通过widgetVar直接修改组件行为 #

给DataTable定义widgetVar后，可在客户端直接重写全选逻辑：

// 假设DataTable的widgetVar为dtWidget
if (#{bean.disabledSelection}) {
    const dt = PF('dtWidget');
    // 重写全选方法为空实现，阻止全选功能
    dt.selectAll = function() {};
    // 禁用表头复选框点击事件
    dt.jq.find('.ui-datatable-header .ui-chkbox').off('click');
}

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