SurveyJS库中动态矩阵面板标题显示值而非文本的问题分析

问题背景

在SurveyJS调查库中，开发人员发现了一个关于动态矩阵(Dynamic Matrix)组件与标签框(Tagbox)组合使用时出现的显示问题。具体表现为：当动态矩阵与标签框组件联动时，动态矩阵的面板标题模板中显示的是选项的值(value)而非对应的文本(text)。

问题复现场景

该问题出现在以下特定配置组合中：

1. 使用Tagbox组件作为选择工具
2. 将Tagbox与Matrixdynamic组件通过valueName属性关联
3. 在Matrixdynamic中设置singleInputTitleTemplate来动态显示每行的标题

在正常情况下，面板标题应显示用户友好的文本标签(如"Slack")，但实际上却显示了原始值(如"slack")，这降低了用户体验。

技术原因分析

经过代码审查，发现问题的根源在于SurveyJS库在处理动态文本模板时，没有正确应用选项的显示文本。具体来说：

1. 当Matrixdynamic组件从关联的Tagbox获取值时，它直接使用了存储的值而非查找对应的显示文本
2. 模板引擎在处理{row.selected-tools}这样的占位符时，默认使用了原始值
3. 虽然SurveyJS提供了useDisplayValuesInDynamicTexts选项，但在这种特定组合下未能生效

解决方案

开发团队通过以下方式修复了这个问题：

1. 修改了模板解析逻辑，确保在处理动态矩阵的行数据时，优先查找并显示选项的文本内容
2. 增强了值到文本的映射处理，即使在复杂的组件联动场景下也能正确显示
3. 确保修复不影响现有的数据收集功能，仅改变显示层的行为

最佳实践建议

在使用SurveyJS构建类似表单时，建议：

1. 对于需要显示友好文本的场景，始终为每个选项提供明确的value和text属性
2. 测试组件间的联动效果，特别是在使用valueName进行数据绑定时
3. 考虑用户界面的一致性，确保所有地方都使用相同的数据表示方式(值或文本)

影响范围

该修复主要影响以下使用场景：

• 使用Tagbox与Matrixdynamic组合的表单
• 依赖模板显示动态内容的调查问卷
• 需要显示友好文本而非原始值的应用场景

此修复已合并到主分支，将包含在下一个稳定版本中发布。