SurveyJS库中矩阵问题行可见性对进度统计的影响分析

问题背景

在SurveyJS这个流行的开源问卷调查库中，存在一个关于矩阵(matrix)类型问题在进度统计时的行为差异问题。具体表现为：当使用onGetProgressText事件获取问卷进度时，其中提供的questionCount参数会将矩阵中所有行(包括不可见行)都计入问题总数，而实际上用户只会回答可见行的问题。

技术细节

SurveyJS提供了onGetProgressText事件，允许开发者自定义问卷进度显示文本。该事件回调函数接收一个包含questionCount和answeredQuestionCount等参数的对象，用于计算完成进度。

survey.onGetProgressText.add(function(sender, options) {
    // options.questionCount 总问题数
    // options.answeredQuestionCount 已回答问题数
});

对于矩阵类型问题，当某些行通过条件逻辑设置为不可见时，库在统计questionCount时仍会将这些不可见行计入总数。这导致进度计算出现偏差，因为用户实际上无法回答这些不可见行的问题。

影响分析

这种不一致行为会导致以下问题：

1. 进度显示不准确：进度百分比会低于实际完成情况，因为分母(总问题数)包含了不可回答问题。
2. 用户体验下降：用户可能困惑为什么完成了所有可见问题但进度仍未达到100%。
3. 数据分析偏差：如果基于进度触发某些逻辑，可能会因为不准确的统计而错误触发。

解决方案

SurveyJS团队在后续版本中修复了这一问题，确保questionCount只统计可见的矩阵行。修复方案主要涉及：

1. 修改矩阵问题的内部计数逻辑，在计算总问题时过滤掉不可见行。
2. 确保onGetProgressText事件中的统计与其他内部统计保持一致。
3. 保持向后兼容性，避免影响现有依赖于旧行为的实现。

最佳实践

开发者在使用矩阵问题和进度统计时应注意：

1. 版本检查：确保使用修复后的SurveyJS版本。
2. 条件逻辑测试：当矩阵行有复杂的可见性条件时，应测试进度统计是否符合预期。
3. 自定义进度计算：如有特殊需求，可考虑基于实际可见问题数实现自定义进度逻辑。

// 自定义进度计算示例
survey.onGetProgressText.add(function(sender, options) {
    const visibleQuestions = sender.getAllQuestions().filter(q => q.isVisible);
    options.questionCount = visibleQuestions.length;
    // 重新计算已回答问题数...
});

总结

SurveyJS对矩阵问题进度统计的修复体现了其对用户体验细节的关注。作为开发者，理解这类边界情况有助于构建更精确的问卷调查系统。在实现复杂问卷逻辑时，特别是涉及条件可见性和动态内容时，应特别注意各种统计指标的准确性。