PrimeFaces DataTable 中 editable 和 editingRow 属性同时使用的注意事项

问题现象

在 PrimeFaces 项目中，当开发者在 DataTable 组件上同时设置 editable="true" 和 editingRow="true" 属性时，会导致所有位于 <p:cellEditor><f:facet name="input"> 中的输入控件被意外禁用，无法正常编辑。

技术背景

PrimeFaces 的 DataTable 组件提供了两种编辑模式：

1. 单元格编辑模式 (cell editing) - 通过 editable="true" 启用
2. 行编辑模式 (row editing) - 通过 editingRow="true" 启用

这两种模式本应可以协同工作，但在实际实现中存在一个逻辑缺陷。

问题根源分析

问题的核心在于 DataTable 组件的 JavaScript 实现中，disableCellEditors 方法的逻辑不够完善。该方法在默认情况下会禁用所有单元格编辑器中的输入控件，但对于处于行编辑模式的单元格，这些输入控件本应保持启用状态。

解决方案

PrimeFaces 核心开发团队提供了一个临时修复方案，通过重写 disableCellEditors 方法来解决这个问题：

if (PrimeFaces.widget.DataTable) {
  PrimeFaces.widget.DataTable.prototype.disableCellEditors = function(element) {
    if (element) {
      $(element).find(":input:enabled").attr('disabled', 'disabled');
    } else {
      $(".ui-cell-editor-input :input:enabled").attr('disabled', 'disabled').attr("data-disabled-by-editor", "true");
      // 特别处理行编辑模式下的行
      this.enableCellEditors($('.ui-row-editing'));
    }
  }
}

这个修复方案的关键改进点在于：

1. 仍然保持原有的禁用逻辑
2. 但额外添加了对行编辑模式行的特殊处理，确保这些行中的输入控件不会被禁用

最佳实践建议

1. 如果需要同时使用单元格编辑和行编辑功能，建议应用上述修复方案
2. 在未来的 PrimeFaces 版本中，这个问题可能会被官方修复，届时可以移除这个临时解决方案
3. 在设计复杂表格编辑功能时，建议先测试编辑功能的交互是否符合预期

技术影响范围

这个问题影响以下版本组合：

• PrimeFaces 社区版 14.0.10
• 使用 JSF 2.3 和 Mojarra 实现
• 在 Java 17 环境下运行

该问题已在最新版本的 PrimeFaces 中得到修复，开发者可以根据自己的项目情况选择升级版本或应用临时修复方案。