PrimeFaces Steps组件中activeIndex高亮失效问题分析

问题背景

在使用PrimeFaces的Steps组件时，开发者发现当同时设置activeStepExecutable="true"和readonly="false"属性时，组件会失去当前步骤的高亮显示效果。具体表现为：即使正确设置了activeIndex属性值，对应的步骤项不会被高亮显示。

问题复现条件

该问题在以下配置组合下会出现：

• 设置了activeStepExecutable="true"（允许执行当前步骤）
• 设置了readonly="false"（非只读模式）
• 明确指定了activeIndex属性值

技术分析

Steps组件是PrimeFaces提供的一个步骤指示器组件，通常用于向导式界面。正常情况下，当前活动步骤会通过添加ui-state-highlightCSS类来显示高亮效果。

当同时启用activeStepExecutable和禁用readonly时，组件的高亮逻辑出现异常。这是因为：

1. readonly="false"允许用户与步骤交互
2. activeStepExecutable="true"允许执行当前步骤
3. 这两种状态的组合导致组件在渲染时未能正确应用高亮样式

临时解决方案

在官方修复前，开发者可以采用以下临时解决方案：

<p:menuitem value="步骤名称" 
           containerStyleClass="#{bean.activeIndex eq 1 ? 'ui-state-highlight' : ''}"/>

通过条件表达式手动为当前活动步骤添加高亮样式类。

官方修复进展

PrimeFaces开发团队已经确认该问题，并将其标记为增强请求(enhancement)。修复方案将涉及：

1. 确保Steps组件在可交互状态下仍能正确显示当前活动步骤
2. 添加相应的JavaScript组件支持（WidgetVar功能）

最佳实践建议

在使用Steps组件时，建议：

1. 如果不需要步骤交互功能，保持readonly="true"（默认值）
2. 需要交互时，仔细测试高亮效果是否符合预期
3. 关注PrimeFaces的版本更新，及时获取官方修复

该问题的修复将包含在未来的PrimeFaces版本中，开发者可以关注更新日志获取具体版本信息。