SurveyJS库中自定义触发器在单题模式下的行为变更分析

SurveyJS作为一款流行的开源问卷库，在2.11.15到2.11.16版本间的重大更新中引入了一个值得开发者注意的行为变更。本文将深入分析这一变更的技术细节及其影响。

问题背景

在SurveyJS的早期版本(2.11.15)中，当使用自定义触发器并设置为单题模式(questionPerPage)时，触发器的执行行为与标准模式存在差异。具体表现为：

1. 自定义触发器会被执行两次：第一次在失去焦点时(isRealExecution为false)，第二次在真实执行时(isRealExecution为true)
2. 在单题模式下，触发器的第二次真实执行可能不会触发

技术细节分析

问题的核心在于SurveyJS对单题模式处理逻辑的变更。在2.11.16版本后，库不再为每个问题动态创建页面，这导致了触发器执行流程的变化。

自定义触发器通常通过继承SurveyTriggerComplete类实现。一个典型的实现如下：

class ScreenoutTrigger extends SurveyTriggerComplete {
  getType() {
    return 'screenouttrigger';
  }

  protected onSuccess(values, properties): void {
    if (this.isRealExecution()) {
      this.owner.setTriggerValue('result', 'screenout', false);
      super.onSuccess(values, properties); // 必须调用父类方法
    }
  }
}

关键发现

1. 执行流程变更：新版本中，单题模式的导航逻辑完全重构，影响了触发器的执行时机
2. 事件系统差异：onCurrentPageChanging事件不再在每个问题切换时触发
3. 父类方法调用：必须显式调用super.onSuccess()才能确保完整功能

解决方案

对于开发者而言，需要注意以下几点：

1. 确保在自定义触发器的onSuccess方法中调用父类实现
2. 对于单题模式，考虑使用新的performNext()方法而非传统的页面导航
3. 需要监听问题变更而非页面变更来实现特定逻辑

最佳实践

1. 触发器设计：始终遵循SurveyJS的触发器继承规范，确保调用父类方法
2. 单题模式适配：使用survey.isSingleVisibleQuestion属性判断当前模式
3. 事件监听：优先使用survey.onTriggerExecuted而非页面变更事件

总结

SurveyJS在2.11.16版本对单题模式的重大重构虽然带来了性能提升，但也改变了部分API行为。开发者需要特别注意自定义触发器在单题模式下的适配问题，确保调用父类方法和使用正确的事件监听方式。